NodeMCU 


15 passos para se tomar um 
mestre em lof 








Ena I E= E. 








Casa do 
Código FERNANDO BRYAN FRIZZARIN 





Sumário 


ISBN 

Agradecimentos 

Sobre o autor 

Como usar este livro 

1. Introdução 

2. O que será necessário ter 

3. Obtendo e preparando o IDE Arduino 

4. Como colocar tudo em prática 

5. Experiência nº 01 - Piscar o LED embutido 

6. Experiência nº 02 - Controlando o LED embutido com um 
botão 

7. Experiência nº 03 - Buscando redes sem fio próximas 

8. Experiência nº 04 - Conectando em uma rede sem fio 

9. Experiência nº 05 - Definindo IP fixo para o NodeMCU 
10. Experiência nº 06 — Conectando em várias redes sem fio 
11. Experiência nº 07 - Criando um servidor Web em seu 
NodeMCU 

12. Experiência nº 08 - Controlando um LED através de uma 
página Web 

13. Experiência nº 09 - Lendo o conteúdo de uma página 
Web 

14. Experiência nº 10 - Mostrando valores de um sensor em 
uma página Web 

15. Experiência nº 11 - NodeMCU funcionando como um 
ponto de acesso 

16. Experiência nº 12 - O sistema de arquivos interno do 
NodeMCU 

17. Experiência nº 13 - Verificando um endereço remoto 
(ping) 

18. Experiência nº 14 — Contando tempo com horas reais 
19. Experiência nº 15 — Execução agendada 

20. Para encerrar: novas possibilidades 


ISBN 


Impresso e PDF: 978-85-/254-008-/ 
EPUB: 978-85-7254-009-4 
MOBI: 978-85-7254-010-0 


Caso você deseje submeter alguma errata ou sugestão, acesse 


http://erratas.casadocodigo.com.br. 





Agradecimentos 


A Deus e meus pais. 


À Priscila, minha esposa, e aos meus filhos, Eduardo e Bruno, 
fontes de inspirações, ajuda e amor infinitos. 


À Letícia Adrielli Luz pela ajuda com o Android. 


Às pessoas criativas que a partir de ideias consideradas inicialmente 
malucas criaram soluções genialmente simples para um mundo 
cada vez mais complexo. 


Às Faculdades Integradas Einstein de Limeira, onde meus amigos 
diretores, coordenadores e professores sempre me incentivam e 
acreditam que eu possa fazer a diferença. 


Sobre o autor 


Eu sou Fernando Bryan Frizzarin, natural de Americana (SP), 
técnico em Informática, bacharel em Ciência da Computação, 
psicopedagogo, especialista em Redes de Computadores e MBA 
em Gestão Estratégica de Negócios. 


Autor dos livros Arduino: guia para colocar suas ideias em prática e 
Arduino Prático: 10 projetos para executar, aprender, modificar e 
dominar o mundo, ambos publicados pela Editora Casa do Código. 


Coordenador e professor do ensino superior no curso de Tecnologia 
em Análise e Desenvolvimento de Sistemas das Faculdades 
Integradas Einstein de Limeira (SP) e chefe da Divisão de 
Administração do Departamento de Água e Esgoto de Americana 
(SP). Sou ainda voluntário na Fundação Romi no Núcleo de Ensino 
Integrado, em Santa Bárbara d'Oeste (SP). 


Sou autor de vários softwares, desenhos industriais e marcas 
registradas no INPI e coautor da patente BR1020140270159/2014: 
Dispositivo automatizado de liberação controlada, projeto 
desenvolvido em conjunto com os alunos Bianca de Mori Machado 
Amaral e Felipe Ferreira da Silva, incluindo apoio da Arq? Marylis 
Barbosa de Souza. Esse projeto foi desenvolvido nas disciplinas de 
Desenvolvimento de Projetos e Tópicos Avançados em Informática 
no Colégio Técnico de Limeira (UNICAMP), e o depósito feito por 
meio da Agência de Inovação da UNICAMP (INOVA). 


Minha grande área de interesse é a inovação e todas as demais 
áreas adjacentes desde capital humano até programação para 
dispositivos embarcados, e toda magnitude de disciplinas, matérias 
e conhecimentos que isso implica. 


Adoro disseminar o conhecimento dando palestras e aulas, mas 
também em um bom papo descompromissado. Basta um convite. 


Como usar este livro 


Tenho convicção de que o melhor é sempre ensinar as ferramentas 
em vez de dar um passo a passo de como chegar ao produto final. 
Isso torna possível libertar e abrir mentes, deixar que a criatividade 
flua e aconteça. 


Existe um conto atribuído à Helen Barckley, que ilustra essa minha 
convicção nos mínimos detalhes que é intitulado “Flor vermelha de 
caule verde!”. 


Nesse conto, resumidamente, é solicitado ao aluno que desenhe 
uma flor. Ele o faz com as cores e formas que lhe vêm a 
imaginação, mas a professora o repreende dizendo: “flores são 
vermelhas de caule verde!”. 


Dizer o que fazer acaba prejudicando a imaginação e criatividade do 
seu aluno, sendo que era apenas preciso dar repertório e indicar 
caminhos do que poderia ser feito, e deixar que o resto fosse obra 
justamente da imaginação e criatividade de cada um. 


Use este livro como um guia de ferramentas e não como fonte de 
projetos terminados. Cuidei para que aqui contenha explicações do 
que pode ser feito e usado e não exatamente o que deve ser feito 
ou usado. 


O conteúdo será rico em detalhes e capaz de lhe fornecer grande 
repertório e novos conhecimentos que podem ser conectados com 
quaisquer outras ideias que você tenha para gerar soluções 
incríveis. 


O único pré-requisito para um bom andamento nos estudos é ter 
noção de Arduino e conhecer a linguagem de programação C usada 
para programá-lo. Caso não tenha esse domínio, antes de começar, 
sugiro a leitura e estudo dos livros Arduino: guia para colocar suas 
ideias em prática e Arduino Prático: 10 projetos para executar, 


aprender, modificar e dominar o mundo, ambos editados pela Casa 
do Código. 


Este livro foi escrito para desafiar você! 


CAPÍTULO 1 
Introdução 


NodeMCU, assim como o Arduino, é uma plataforma de código 
aberto (open source) e hardware aberto (open hardware), para 
desenvolvimento de equipamentos na filosofia da Internet das 
Coisas, ou loT (Internet of Things). 


Ele é baseado no microcontrolador de fabricação chinesa chamado 
ESP8266 que inclui um módulo de comunicação WiFi. O ESP8266 
chegou primeiro como um módulo WiFi para ser utilizado com o 
Arduino, que apresenta, além da capacidade de conectar-se e 
interagir com equipamentos e ambientes baseados na pilha de 
protocolos TCP/IP, dois pinos GPIO, General Purpose Intput/O utput 
ou Entrada e Saída de Uso Geral, alimentação de 3,3V e 
compatibilidade com os modos de segurança WiFi WEP e WPA. 


Todas essas especificações também estão presentes no NodeMCU, 
mas com adicionais: comunicação USB-serial para conexão ao 
computador, mais pinos GPIO, bootloader compatível com a 
linguagem de programação LUA e Arduino e tudo isso aliado ao 
tamanho reduzido. 


Parte do sucesso do NodeMCU pode ser explicado pelo seu preço 
de algumas poucas dezenas de reais, pela facilidade de 
programação já que compartilha a linguagem do Arduino e pela 
capacidade de comunicação via redes WiFi. 


Compartilhar o conjunto de comandos e bibliotecas do Arduino 
ajuda muito quem já tiver algum conhecimento ou familiaridade com 
a programação para o Arduino, mas o NodeMCU tem seu próprio o 
conjunto de comandos, funções e bibliotecas específicas para lidar 
com o WiFi e toda a pilha de protocolos TCP/IP. 


Há uma imensidão de possibilidades e facilidades disponíveis ao 
programador e à programadora no uso do NodeMCU, elevando os 


projetos antes baseados apenas em Arduino a um patamar superior 
dentro da filosofia da loT. 


Todas as experiências do livro foram concebidas para usar 
componentes externos fáceis de encontrar e baixíssimo custo. 
Como estou partindo do princípio de que você tem algum 
conhecimento sobre o uso e programação do Arduino, as 
experiências foram focadas para explorar ao máximo a interação 
com o ambiente de rede. Mas, como você poderá perceber ao longo 
do livro, será muito simples adicionar sensores, atuadores e 
componentes diversos nesse universo. 


Tenha sempre em mente que, a partir de agora, na verdade já faz 
algum tempo, os/as profissionais de TI não podem mais apenas 
ater-se ao bom e velho microcomputador. Tão pouco aos 
dispositivos móveis, como os celulares, tablets etc. Há um novo 
mundo à disposição, a eletrônica evoluiu muito e já não funciona por 
Si só, precisa indissociavelmente de um software no comando. Sem 
um programa, pouca coisa com eletrônica embarcada funciona e 
esse é um nicho de mercado que não podemos ignorar. 


Profissionais da Engenharia eletrônica e mecatrônica não fazem 
muito sem saberem programar, o pessoal da TI também já não faz 
nada muito extraordinário sem saber um pouco de eletrônica e estar 
de olho na Internet das Coisas. 


Foco e bons estudos! 


CAPÍTULO 2 
O que será necessário ter 


Ter um NodeMCU é imprescindível. Mão na massa! Vamos 
desenvolver e carregar programas nele para realizar nossos testes: 
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Figura 2.1: O NodeMCU 





Figura 2.2: O NodeMCU de perfil 


Junto ao NodeMCU será necessário ter um cabo de conexão entre 
ele e um computador. Esse cabo é do tipo USB-B e Micro-B, desses 
que usamos para carregar alguns celulares. 





Figura 2.3: Cabo USB necessário para ligar o NodeMCU ao computador 


Para realizar todas as experiências também será necessário ter uma 
prot-o-board: 





Figura 2.4: Uma prot-o-board. Existem muitos modelos no mercado que também servem 


Também será necessário um botão, que pode ser qualquer um, a 
sua escolha. Eu usei um interruptor temporário sem trava com botão 


longo, que deixa mais fácil apertá-lo em meio a fios em uma prot-o- 
board: 





Figura 2.5: Um botão. Outros tamanhos e modelos também servirão 


Um potenciômetro. No caso deste livro usei um de 10KQ com 
terminais para prot-o-board. Potenciômetros como esse são muitos 
fáceis de achar e têm baixo custo: 





Figura 2.6: Um potenciômetro de 10KQ 


E alguns cabinhos (wire-jumpers) do tipo macho-macho: 





Figura 2.7: Wire-jumpers (cabinhos) 


Prossiga! Não ter a prot-o-board, o botão, o potenciômetro e os 
cabinhos não impedirão de continuar com este livro. Há muita coisa 
para aprender ainda assim! A maioria das experiências não 
dependerá de ter esses componentes periféricos. 


Também será necessário ter um computador conectado à internet 
para fazer download do IDE Arduino, suas bibliotecas e para 
carregar o programa ao NodeMCU. 


Para desenvolver e testar a conexão com a rede WiFi e a internet, 
eu utilizei o compartilhamento de internet do meu celular apenas por 


comodidade; você poderá conectar o NodeMCU à sua rede 
doméstica ou empresarial para fazer isso, basta ter acesso a um 
roteador ou Access Point, claro, sabendo o nome da rede e a senha 
para conectar-se a ela. 


Preparado? Hora de começar! 


CAPÍTULO 3 
Obtendo e preparando o IDE Arduino 


Para começarmos, você precisará baixar a última versão do IDE 
Arduino em seu computador e instalá-la. Para isso acesse o 
http://www.arduino.cc/. 
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Figura 3.1: Site oficial do Arduino em www.arduino.cc 


Acesse a opção software no topo da página e clique na opção 
Downloads . Na página que será acessada você terá a opção Download 


the Arduino IDE € à direita todas as versões para todos os sistemas 
operacionais disponíveis. 


00) HOME 


BUY SOFTWARE 


Download the Arduino IDE 


OO 


ARDUINO 1.8.5 

The open-source Arduino Software (IDE) makes it easy to 
write code and upload it to the board. It runs on 
Windows, Mac OS X, and Linux. The environment is 
written in Java and based on Processing and other open- 
source software 

This software can De used with any Arduino board. 

Refer to the Getting Started page for Installation 
instructions. 


PRODUCTS EDU RESOURCES COMMUNITY HELP 


a ê 


SIGN IN 


Windows installer, for Windows XP and up 
Windows ZIP file for non admin install 


Windows app Requires Win 8.1 or 10 


Mac OS X 107 Lion or newer 


Linux 32 bits 
Linux 64 bits 
Linux ARM 


Release Notes 
Source Code 
Checksums (sha512) 





HOURLY BUILDS BETA BUILDS 


Download a preview of the incoming release with the most 
updated features and bugfixes 





Download the Beta Version of the Arduino IDE with 
experimental features. This version should NOT be used in 
production. 


Windows 
Mac OS X (Mac OSX Lion or later) 
Linux 32 bit , Linux 64 bit , Linux ARM 


Windows 
Mac OX (Mac OSX Mountain Lion or later) 
Linux 32 bit, Linux 64 bit, Linux Arm 


Figura 3.2: Links com as versões de sistemas operacionais suportados pela IDE Arduino 


Escolhendo o seu sistema operacional, na página de download 
propriamente dita, será sugerido que você faça uma doação para 
manter o projeto. Fazê-lo ajudará que o projeto Arduino seja 
mantido e também ampliado. Caso não queira contribuir não há 
problema, use o link Just Download . 
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Contribute to the Arduino Software 


Consider supporting the Arduino Software by contr alenak de its development. (US tax payers, please note this contribution 
is not tax deductible). Learn more on how your contribution will be used 


SINCE MARCH 2015, THE ARDUINO IDE HAS BEEN DOWNLOADED 

TIMES. (IMPRESSIVE!) NO LONGER JUST FOR ARDUINO AND 
GENUINO BOARDS, HUNDREDS OF COMPANIES AROUND THE WORLD ARE 
USING THE IDE TO PROGRAM THEIR DEVICES, INCLUDING COMPATIBLES 
CLONES, AND EVEN COUNTERFEITS. HELP ACCELERATE ITS DEVELOPMENT 
WITH A SMALL CONTRIBUTION! REMEMBER: OPEN SOURCE IS LOVE! 
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Figura 3.3: Página de download com sugestão de contribuição e o link “Just Download” 


Para a instalação não há qualquer segredo, basta seguir as 
instruções na tela. 


Com a instalação completa, precisaremos configurar a IDE para que 
seja possível programar o NodeMCU através dela, vamos trabalhar! 


Com a IDE aberta encontre o menu arquivo : 


sketch | Arduino 1.8.5 — o x 


Arquivo Editar Sketch Ferramentas Ajuda 


sketch 


boid setup() { 
// put your setup code here, to run once: 


void loop() { 
// put your main code here, to run repeatedls 


Arduino Yún em COMS 





Figura 3.4: A IDE Arduino 


No menu arquivo há uma opção Preferências , clique nela. 


Na tela que aparecer, encontre a opção URLs adicionais para 


Gerenciadores de Placas: , Na frente da qual tem um campo para você 
digitar, como na figura a seguir: 





Preferências 


| Configurações Rede 


Local do Sketchbook: 


C:Usersd 1396 Documents Arduino] Navegador 


Idioma do editor: Padrão do Sistema wv | (requer reinicialização do Arduino) 
Tamanho da fonte do editor: 12 
Escala de interface: Automático 100 $ % (requer reinicialização do Arduino) 
Mostrar mensagens de saída durante: [ | compilação [ ] carregar 

| Avisos do compilador: Nenhum v 

[ ] Mostrar números de linhas 

[7] Habilitar Dobramento de Código 

[4] Verificar código depois de carregar 

[C] Usar editor externo 

[7] Aggressively cache compiled core 

[7] Checar atualizações ao iniciar 

[4] Atualizar arquivos de sketch para nova extensão ao salvar (.pde -> .ino) 

[7] Salve ao verificar ou carregar 








URLs Adicionais para Gerenciadores de Placas: É 


C:Usersid 1396/AppData Localiárduino 15ipreferences. txt 


Figura 3.5: Tela de preferências da IDE Arduino 


No campo da Opção URLs Adicionais para Gerenciadores de Placas: 
digite: 

http://arduino.esp8266.com/stable/package esp8266com index. json 

Esse é o endereço onde a IDE encontrará e efetuará o download de 


todas as configurações, bibliotecas e referências para que seja 
possível realizar a programação do NodeMCU através dela. 








Preferências 
Configurações Rede 

Local do Sketchbook: 
C:Users'Priscila Documents Arduino Navegador 
Idioma do editor: Padrão do Sistema v (requer reinicialização do Arduino) 

Tamanho da fonte do editor: 12 
Escala de interface: [V] Automático 100 $ % (requer reinicialização do Arduino) 
Mostrar mensagens de saída durante: [ ] compilação [ ] carregar 

Avisos do compilador: Nenhum v 

[C] Mostrar números de linhas 

[1] Habilitar Dobramento de Código 

[4] Verificar código depois de carregar 

[1] Usar editor externo 

[9] Aggressively cache compiled core 

[4] Checar atualizações ao iniciar 

[4] Atualizar arquivos de sketch para nova extensão ao salvar (.pde -> .ino) 

[4] Salve ao verificar ou carregar 
URLs Adicionais para Gerenciadores de Placas: http://arduino.esp8266.com/stable package esp8266com index.json É 
C:jUsers'Priscila VappData LocalyArduino 15lpreferences. txt 


fais preferências podem ser editadas direta 
: O Arduir 


iça 





Figura 3.6: Tela de preferências com o endereço preenchido 


Uma vez digitado, clique no botão ok abaixo e à direita da tela. 
Agora será necessário reiniciar a IDE: feche-a e abra-a novamente. 


De volta com a IDE Arduino aberta, abra o menu Ferramentas € 
selecione a opção placa . Você verá então a opção cerenciador de 
Placas , Clique nela e a seguinte tela deverá abrir: 








3 Gerenciador de Placas xX 


Tipo Todos 7 f | |Refine sua busca... 





Arduino AVR Boards by Arduino versão 1.6.21 INSTALLED A 
Placas incluídas nesse pacote: 

Arduino Yún, Arduino/Genuino Uno, Arduino Uno WiFi, Arduino Diecimila, Arduino Nano, Arduino/Genuino Mega, Arduino 

MegaADK, Arduino Leonardo, Arduino Leonardo Ethernet, Arduino/Genuino Micro, Arduino Esplora, Arduino Mini, Arduino Ethernet, 
Arduino Fio, Arduino BT, Arduino LilyPadUSB, Arduino Lilypad, Arduino Pro, Arduino ATMegaNG, Arduino Robot Control, Arduino 

Robot Motor, Arduino Gemma, Adafruit Circuit Playground, Arduino Yún Mini, Arduino Industrial 101, Linino One. 


Online help 
More info 





Arduino SAM Boards (32-bits ARM Cortex-M3) by Arduino 
Placas incluídas nesse pacote: 

Arduino Due. 

Online help 

More info 





Arduino SAMD Boards (32-bits ARM Cortex-MO+) by Arduino 

Placas incluídas nesse pacote: 

Arduino/Genuino Zero, Arduino/Genuino MKR 1000, Arduino MKRZERO, Arduino MKR FOX 1200, Arduino MKR WAN 1300, Arduino 

MKR GSM 1400, Arduino MO Pro, Arduino MO, Arduino Tian, Adafruit Circuit Playground Express. 

Online help é 

















Figura 3.7: Tela do Gerenciador de Placas 


No campo no topo da tela digite esps266 , como na imagem a seguir, 
e deverá ser encontrada a biblioteca ESP8266 Community. 





foc] Gerenciador de Placas X 


Tipo Todos wv | esp8266 


Placas incluídas nesse pacote: 

Generic ESP8266 Module, Generic ESP8285 Module, ESPDuino (ESP-13 Module), Adafruit Feather HUZZAH ESP8266, ESPresso Lite 
1.0, ESPresso Lite 2.0, Phoenix 1.0, Phoenix 2.0, NodeMCU 0.9 (ESP-12 Module), NodeMCU 1.0 (ESP-12E Module), Olimex 
MOD-WIFI-ESP8266(-DEV), SparkFun ESP8266 Thing, SparkFun ESP8266 Thing Dev, SweetPea ESP-210, WeMos D1 R2 & mini, 
WeMos D1 mini Pro, WeMos D1 mini Lite, WeMos D1 R1, ESPino (ESP-12 Module), ThaiEasyElec's ESPino, WifInfo, Arduino, 4D 
Systems gen4 IoD Range, Digistump Oak. 

Online help 

More info 


v| | Instalar 

















Figura 3.8: Gerenciador de Placas com a biblioteca para o ESP8266 encontrada 


Selecione a versão mais recente e clique na opção Instalar € 
aguarde. 





I 
© Gerenciador de Placas xX 
Tipo Todos esp8266 


| esp8266 by ESP8266 Community A 
| Placas incluídas nesse pacote: 
| Generic ESP8266 Module, Generic ESP8285 Module, ESPDuino (ESP-13 Module), Adafruit Feather HUZZAH ESP8266, ESPresso Lite 
1.0, ESPresso Lite 2.0, Phoenix 1.0, Phoenix 2.0, NodeMCU 0.9 (ESP-12 Module), NodeMCU 1.0 (ESP-12E Module), Olimex 
| MOD-WIFI-ESP8266(-DEV), SparkFun ESP8266 Thing, SparkFun ESP8266 Thing Dev, SweetPea ESP-210, WeMos D1 R2 & mini, 
| WeMos D1 mini Pro, WeMos D1 mini Lite, WeMos D1 R1, ESPino (ESP-12 Module), ThaifasyElec's ESPino, WifInfo, Arduino, 4D 
| Systems gen4 IoD Range, Digistump Oak. 
| Online help 
More info 


Instalando... 











Figura 3.9: Instalação da biblioteca para o ESP8266 


Depois de instalado você terá que reiniciar a IDE. Feche todas as 
janelas, e feche a IDE Arduino. Reabra-a em seguida. 


Você verá que na opção Placas do menu Ferramentas há várias opções 
referentes ao ESP8266 no qual se inclui o NodeMCU: 





FP 
Arduino Pro or Pro Miimi 
Arduino NG or older 
Arduino Robot Control 
Arduino Robot Motor 
Arduino Gemma 
Adafruit Circuit Playground 
Arduino Yün imã 
Arduino Industrial 101 
Linino One 
Arduino Uno WiFi 
ESP8266 Modules 
Generic ESPS266 Module 
Generic ESP8285 Module 
ESPDuino (ESP-13 Module) 
Adafruit Feather HUZZAH ESPB266 
ESPresso Lite 1.0 
ESPresso Lite 2.0 
Phoenix 1.0 
Phoenix 2.0 
MNodeMCU 0.9 (ESP-12 Module) 
NodeM OU 1.0 (ESP-12E Module) 
Olimex MOD-WIFI-ESPB266(-DEV) 
SparkFun ESP8266 Thing 
SparkFun ESPB266 Thing Dew 
SweetPea ESP-210 
Wrelios D1 R2 & mimi 
WieMos D1 mini Pro 
WieMos D1 mini Lrte 
wWieMos D1 R1 
ESPino (ESP-12 Module) 
ThaiEasyElec's ESPino 
WiFimo 
Arduino 
Digistump Oak 


Figura 3.10: Opções de placas para o NodeMCU 


Para as experiências deste livro vou sempre usar a placa NodeMCU 
0.9 (ESP-12 Module), que é compatível com o módulo NodeMCU 
que possuo. A maioria dos módulos NodeMCU são compatíveis com 
essa configuração, mas caso o seu não dê certo, basta usar a 
opção que melhor se adapte ao seu projeto. 


Na imagem a seguir estão as configurações para o módulo usado: 





sketch | Arduino 1.8.5 — o X 


Arquivo Editar Sketch Ferramentas Ajuda 





Autoformatação Ctrl+T 
Arquivar Sketch 
sketch Corrigir codificação e recarregar 
void setup() { Monitor serial Ctrl+Shift+M |^ 
ER RIR E ME Plotter serial Ctrl+Shift+L 
} WiFi101 Firmware Updater 
RR E Placa: "NodeMCU 0.9 (ESP-12 Module)" > 
/ put your mainii i Mash Size: "4M (1M SPIFFS)" > 
} Debug port: "Disabled" > 
Debug Level: "Nenhum" > 
IwIP Variant: "v2 Lower Memory" > 
CPU Frequency: "80 MHz" > 
Upload Speed: "115200" > 
Erase Flash: "Only Sketch" > 
Porta: "COM3" > 
Obter informações da Placa 
Programador: "AVRISP mkll” > 
Gravar Bootloader - 








118), 80 MHz, 4M (1M SPIFFS), v2 Lower Memory, Disabled, None, Only Sketch, 115200 em COM3 


Figura 3.11: Configurações para o módulo NodeMCU 


Depois de selecionar a placa, você deve atentar-se para a porta 
serial a ser utilizada. Normalmente a IDE Arduino detecta 


automaticamente em qual porta o NodeMCU está conectado, mas 
caso não detecte você deverá usar O Gerenciador de Dispositivos dO 
seu Windows para localizá-la. 





A Gerenciador de Dispositivos 
Arquivo Ação Exibir Ajuda 
eSimB|Bm|IPI Ex 


> ĝa Controladores de armazenamento 

> äl Controladores de som, vídeo e jogos 

> "a Controladores IDE ATA/ATAPI 

ð y Controladores USB (barramento serial universal) 

> # Dispositivos de Interface Humana 

> E? Dispositivos de segurança 

> É Dispositivos de sistema 

> E Dispositivos do software 

> EB Dispositivos Portáteis 

> W Entradas e saídas de áudio 

> G Filas de impressão 

> m Firmware 

> 3 Impressoras 

> [E Monitores 

> (1) Mouse e outros dispositivos apontadores 

v WE Portas (COM e LPT) 
[=] Intel(R) Active Management Technology - SOL (COM3) 
[=] Porta de comunicação (COMI) 
{Ñ Porta de comunicação (COM2) 
ff Porta de Impressora ECP (LPT1) 
[=| Silicon Labs CP210x USB to UART Bridge (COMS5) 

> [O Processadores 

> Teclados 

> «ss Unidades de disco 

> «a Unidades de DVD/CD-ROM 








Figura 3.12: Gerenciador de Dispositivos do Windows com o conversor USB-Serial do 
NodeMCU na porta COM5 


Identificada a porta COM correta, basta selecioná-la no IDE, como 
na imagem a seguir: 





sketch.ino | Arduino 1.8.5 


Arquivo Editar Sketch Ferramentas Ajuda 


sketch.ino 





void setup() { 


put your setu 





Autoformatação 

Arquivar Sketch 

Corrigir codificação e recarregar 
Monitor serial 


Plotter serial 
WiFi101 Firmware Updater 


Placa: "NodeMCU 0.9 (ESP-12 Module)" 
Flash Size: "4M (1M SPIFFS)" 

Debug port: "Disabled" 

Debug Level: “Nenhum” 

IwIP Variant: "v2 Lower Memory” 
VTables: "Flash" 

CPU Frequency: "80 MHz" 

Upload Speed: "115200" 

Erase Flash: "Only Sketch" 

Porta: "COM5" 


Obter informações da Placa 


Programador: “AVRISP mkil” 


Gravar Bootloader 


Ctrl+T 





Ctrl+ Shift+M a 
Ctrl+Shift+L 





(ESP-12 Module), 80 MHz, Flash, 4M (1M SPIFFS), v2 Lower Memory, Disabled, None, Only Sketch, 115200 em COMS 


Figura 3.13: Selecionando a porta COM correta para o NodeMCU 


Pronto! Estamos preparados para começar as experiências. Só falta 
uma breve orientação de como colocar tudo em prática, vamos lá! 


CAPÍTULO 4 
Como colocar tudo em prática 


Para colocar em prática todas as experiências, que começam a 
seguir, você precisará de pouca coisa além do NodeMCU. Como já 
mostrado anteriormente, para algumas experiências, bastará um 
botão, um potenciômetro, uma prot-o-board, alguns cabinhos e o 
próprio NodeMCU. 


Mas caso você não esteja familiarizado com a montagem eletrônica, 
é importante dar as devidas explicações de como a prot-o-board 
funciona e como colocar os componentes nela. 


A prot-o-board é uma placa plástica com vários orifícios. Há vários 
modelos, formas e tamanhos, mas o funcionamento é o mesmo em 
todas elas. 
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Figura 4.1: A prot-o-board ou placa de ensaios. Fonte: Frizzarin (2016) 


Dentro desses orifícios há contatos metálicos dispostos como nas 
figuras a seguir. 





Figura 4.2: A disposição dos contatos metálicos na prot-o-board. Fonte: Frizzarin (2016) 


Quando chegar à segunda experiência você terá a montagem de um 
botão na prot-o-board e este ao NodeMCU. Considerando o chanfro 
central da placa de ensaios, que separa os contatos, vamos ligar o 
NodeMCU da seguinte forma: 





Figura 4.3: O NodeMCU na prot-o-board 


Na sequência colocaremos o botão da mesma maneira, fazendo 
com que os contatos não sejam ligados entre si, ou seja, vamos 
colocá-lo aproveitando o chanfro central da placa. 





Figura 4.4: O botão na prot-o-board 


Porém, o botão não está fisicamente ligado ao NodeMCU ainda por 
causa da disposição interna dos contatos da prot-o-board, como 
vimos anteriormente. Para ligar um no outro usaremos cabinhos 


(wire-jumpers). 


Um cabinho ligará um lado do contato do botão a um pino específico 
do NodeMCU e outro cabinho para o segundo contato. 





Figura 4.5: Cabinhos ligando o botão ao NodeMCU 


Lá na experiência mostrarei tudo isso com mais detalhes, mas esse 
modo de realizar as ligações valerá para todas as experiências que 
requererão montagens externas, porém para a maioria delas não 
será necessário. 


Para todas as experiências que não precisarão de montagem 
externa vamos precisar apenas do NodeMCU ligado ao computador 
e de um roteador ou celular compartilhando a internet. 


O roteador ou celular com internet compartilhada servirá para testar 
a conexão com a rede WiFi e a internet. Eu usei meu celular para 

isso pela comodidade e facilidade de controlar a conexão, mas você 
poderá conectar o NodeMCU à sua rede doméstica ou empresarial, 


basta ter acesso a um roteador ou Access Point, sabendo o nome 
da rede e a senha. 


Se for usar seu celular veja no manual dele como compartilhar a 
conexão a internet e esteja alerta de que seu plano de dados poderá 
ser consumido e, mesmo que esse consumo seja mínimo, verifique 
se há possibilidade de fazer isso. 


A tela de compartilhamento de internet em um celular com sistema 
operacional Android é esta a seguir: 


né «d 88% E 09:52 





Ativado 


(13) AndroidAP f 


SENHA 





12345678 





DISPOSITIVOS CONECTADOS 


Nenhum dispositivo 





COMO CONECTAR A PARTIR DE OUTROS DISPOS... 


1. Ative o Wi-Fi no aparelho que 
compartilhará sua conexão de rede móvel. 

2. Selecione AndroidAP da lista de redes Wi- 
Fi disponíveis. 

3. Conecte-se a AndroidAP inserindo 
12345678 como a senha. 


Figura 4.6: Tela de compartilhamento de internet em celular com o sistema operacional 
Android 


Já para um celular com sistema operacional iOS a tela de 
compartilhamento de internet é esta que está a seguir: 


Acesso Pessoal: 1 Conexão 





< Ajustes Acesso Pessoal 





Acesso Pessoal € ` 


Visível. 


Outros usuários podem procurar sua rede compartilhada 
usando Wi-Fi e Bluetooth (a rede aparecerá com o nome 
“iPhone de Fernando Bryan”). 


Senha Wi-Fi biycoj/sbs9cs 


sm PARA CONECTAR VIA WI-FI 


1. Escolha “iPhone de Fernando Bryan” nos 
ajustes de Wi-Fi em seu computador ou em 
outro dispositivo. 


2. Digite a senha quando solicitado. 


PARA CONECTAR VIA BLUETOOTH 
1. Emparelhe o iPhone com o seu computador. 


2. No iPhone, toque em Emparelhar ou digite o 
código que aparece no seu computador. 


3. Conecte ao iPhone do computador. 


PARA CONECTAR VIA USB 
1. Conecte o iPhone ao seu computador. 


2. Escolha iPhone na lista de serviços de rede dos 
seus ajustes. 


Figura 4.7: Tela de compartilhamento de internet em celular com o sistema operacional iOS 


Não se preocupe porque a senha do meu celular está na imagem 
anterior e aparecerá em todos os exemplos, ela foi alterada depois 
que o livro foi concluído. ;) 


Todos os códigos-fontes do livro estão no meu repositório do 
GitHub: https://github.com/fbryan/Codigo fonte NodeMCU/. 


Vamos colocar tudo em prática? Mãos à obra! 


CAPÍTULO 5 
Experiência nº 01 - Piscar o LED embutido 


Esta é a experiência mais simples que se pode fazer. É o nosso 
“Hello World". 


A ideia aqui é que você acostume-se com as tarefas mínimas 
necessárias para programar seu NodeMCU, como ligá-lo ao 
computador, usar o IDE Arduino, compilar o código e enviá-lo para o 
NodeMCU. 


Faremos os passos um a um, detalhadamente, pois eles serão 
praticamente os mesmos durante as demais experiências. Sempre 
que houver dúvidas nesses passos iniciais recorra a essa 
experiência para relembrá-los. Depois de um tempo, você terá tudo 
guardado na cabeça. 


Como vimos anteriormente, o LED que vamos acionar está 
embutido na placa do NodeMCU, próximo ao botão de Reset (RST) 
e está ligado ao pino GPIO 16, identificado como pe . 


Vamos apenas acender o LED embutido por um segundo, apagá-lo 
por um segundo também e voltar a acendê-lo. Como tudo estará na 
função 1oo0p() O LED irá piscar sem parar, em intervalos de um 
segundo, até que o NodeMCU seja desligado ou o programa seja 
trocado por outro. 


O que será necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária. Apenas ligue seu NodeMCU ao seu 
computador. 





Figura 5.1: NodeMCU ligado ao computador via cabo USB 


Programação: 


void setup() 1 
pinMode(LED BUILTIN, OUTPUT); 


} 


void loop() { 
digitalwrite(LED_BUILTIN, LOW); 
delay(1000); 
digitalWrite(LED BUILTIN, HIGH); 
delay(1000); 

} 


Para compilar e enviar o código ao NodeMCU, considerando que as 
configurações de placa e porta já estão feitas (caso não estejam, 
volte ao capítulo anterior para rever como realizar isso), basta clicar 
no botão carregar do IDE e aguardar a mensagem de concluído. 


01. Piscar o LED com delay | Arduino 1.8.5 — O x 











| Arquivo Editar Sketch Ferramentas Ajuda 


01. Piscar o LED com delay 





void setup() { 
pinMode (LED BUILTIN, OUTPUT); 


void loop() { 
digitalWrite (LED BUILTIN, LOW); 
delay (1000); 

digitalWrite (LED BUILTIN, HIGH); 
delay (1000); 


MHz, Flash, 4M (1M SPIFFS), v2 Lower Memory, Disabled, None, Only Sketch, 115200 em COMS 


Figura 5.2: IDE compilando o código-fonte para na sequencia enviá-lo ao NodeMCU 


O que foi feito: 


Na função setup() , que é executada apenas uma vez como no 
Arduino, ajustamos o pino do LED embutido como saída, usando o 
comando pinMode(LED BUILTIN, OUTPUT) . LED BUILTIN é UMa palavra 
reservada para uma constante que contém o valor 16, que indicará 
o pino GPIO 16 ( pe ). 


Na função 100p() acendemos o LED com o comando 
digitalwrite(LED BUILTIN, LOW) € aguardamos um segundo com o 
comando delay(1008) . Para o comando delay , O tempo é informado 
em milissegundos, ou seja, para um segundo passamos o valor 
1000, para meio segundo passamos 500 e assim por diante, dessa 
forma delay(1000) causará uma pausa de um segundo para a 
execução do programa. Seguindo essa lógica, na sequência, 
apagamos o LED com o comando digitalwrite(LED BUILTIN,HIGH) € O 
mantemos assim por um segundo usando novamente o comando 
delay(1000) . 


Resultado esperado: 


Depois de compilar e carregar o programa em seu NodeMCU, você 
terá a confirmação visual de que está tudo funcionando com o LED 
embutido piscando, isto é, mantendo-se ligado por um segundo, e 
na sequência mantendo-se desligado por um segundo, em acordo 
com a programação. 


Desafio: 


Usando a prot-o-board, um resistor, um LED e pelo menos dois 
cabinhos, monte um circuito para piscar um LED externo ao 
NodeMCU. 


Para começar, lembre-se de que o pino que está interconectado ao 
LED embutido é o pino GPIO 16 (DO), assim, se você conectar seu 
LED externo a esse pino ele piscará junto ao LED embutido e o 
código será o mesmo. 


Para ligar seu LED a qualquer outro pino, a programação será a 
mesma, bastando mudar a definição do pino em que o LED estará 
conectado. Para saber a descrição de todos os pinos do NodeMCU 
dê uma olhada na próxima experiência, lá tem uma tabela com a 
identificação e descrição de cada pino existente no NodeMCU. 


Esses primeiros passos são importantes para que você se 
familiarize com a mecânica de programar, compilar, enviar o 
programa ao NodeMCU e verificar seu funcionamento. Também 
para que você perceba na prática que tudo isso é exatamente o 
mesmo que você já está acostumado fazer no Arduino. 


Feito isso, você pode ir aprimorando o projeto até que você tenha 
um semáforo, que tal? 


Na próxima experiência... 


... Vamos ver como acender o LED embutido usando um botão. Com 
isso, você saberá como usar quaisquer tipos de botões para 
controlar qualquer coisa em seu NodeMCU. 


CAPÍTULO 6 
Experiência nº 02 - Controlando o LED embutido 
com um botão 


Nesta experiência usaremos um botão momentâneo externo 
conectado ao NodeMCU para controlar o LED embutido nele. 


Faremos duas experiências em uma: o esquema de montagem será 
o mesmo, mas testaremos dois códigos diferentes. 


No primeiro, ao apertar o botão, o LED acenderá e ficará aceso 
enquanto você mantiver o botão pressionado. No segundo, você 
apertará o botão, o LED acenderá e ficará aceso até que você 
aperte-o novamente. 


Esse é um bom exemplo da predominância do software sobre o 
hardware, já que mudaremos completamente o funcionamento do 
botão sem alterar qualquer coisa no hardware, apenas com 
programação, dependendo apenas dos objetivos e necessidades de 
quem o programa. 


O que é necessário: 


e 1 x NodeMCU 

e 1 x Cabo USB 

e 1 x Prot-o-board 

e 1 x Botão (chave momentânea) 
e 2 x Cabinhos 


Esquema de montagem: 


Coloque o NodeMCU na prot-o-board aproveitando-se do chanfro 
central, conforme a imagem a seguir: 





Figura 6.1: NodeMCU colocado na prot-o-board 


Na sequência, coloque o botão. Se seu botão tiver 4 terminais, 
como o que estou usando, você deve separá-los pelo chanfro 
central, como na próxima imagem. Caso tenha só 2 terminais, não 
há necessidade disso, você deve colocá-lo em orifícios diferentes 
para cada terminal. 





Figura 6.2: O botão colocado na prot-o-board 


Para que fique tudo mais claro e você possa se localizar, na tabela a 
seguir temos a descrição de todos os pinos do NodeMCU. 


Marcação na placa Descrição pino 


3V3 3,3V 
GND Terra 
TX GPIO1 
RX GPIOS3 
D8 GPIO15 
D7 GPIO13 
D6 GPIO12 
D5 GPIO14 
GND Terra 
3V3 3,3V 
D4 GPIO2 
D3 GPIOO 
D2 GPIO4 
D1 GPIO5 
DO GPIO16 
Vin Vin 
GND Terra 
RST Reset 
EN EN 

3V3 3,3V 
GND Terra 


CLK Clock 


Marcação na placa Descrição pino 


SDO MISO 

CMD CS 

SD1 MOSI 

SD2 GPIO9 

SD3 GPIO1 

RSV Reservado0O 
RSV Reservado 
AO ADCO 


Tabela 01 — Os pinos do NodeMCU 


Nessa tabela, temos a Marcação na placa, que indica o que está 
estampado na placa do NodeMCU, junto a cada pino disponível. 
Essa é a referência visual de cada um dos pinos. 


Em Descrição Pino, temos a descrição do que é cada pino e sua 
correspondência em GPIO — General Purpose Input/O utput -, ou 
seja, qual a destinação dos pinos. 


Na programação, o número do pino não será o mesmo que está 
marcado na placa, por exemplo, DO, D1 e assim sucessivamente. 
No código, o número do pino será o número GPIO dele. No caso do 
pino marcado na placa como DO, será 16 na programação 
(GPIO16). Dessa forma, veja o trecho de código a seguir: 


pinMode(12, INPUT PULLUP); 


Nesse caso ajustamos o pino 12 (GPIO 12) como entrada e 
ativamos o resistor pull-up existente nele. Note que o GPIO 12 está 
marcado na placa como D6 (Digital 6). 


Preste atenção aos pinos GND (Terra) que são comuns. Todos têm 
a mesma função e são interligados entre si. Os pinos 3,3V podem 
prover essa voltagem a equipamentos externos, mas respeitando-se 
a corrente máxima da fonte de alimentação. Já o pino vin pode 
receber alimentação externa com, no máximo, 9V. Ele pode facilitar 
a interligação do NodeMCU com equipamentos externos 
compartilhando a fonte de energia elétrica, já que não é possível 
encontrar fontes USB com facilidade em alguns tipos de máquinas. 
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Figura 6.3: NodeMCU em detalhes 


Considerando tudo isso, é só ligar os contatos do botão aos pinos 
do NodeMCU usando cabinhos. Um terminal do botão vai ao pino 
GPIO 12, que na placa está grafado como ps , e o outro vai ao pino 
cnp . Como na imagem a seguir: 





Figura 6.4: Cabinhos ligando o botão ao NodeMCU 


Ligações feitas, só nos resta programar, vamos nessa! 
Programação: 

int botao = 12; 

void setup() 1 


pinMode (LED BUILTIN, OUTPUT); 
pinMode (botao, INPUT PULLUP); 


} 


void loop() { 
int leitura = digitalRead(botao); 
if(leitura == LOW) { 
digitalwrite(LED BUILTIN, LOW); 
+ else { 
digitalWrite(LED BUILTIN, HIGH); 


} 
} 


O que foi feito: 


Começamos declarando uma variável do tipo inteiro em int botao = 
12; , que indicará em que pino GPIO o botão está ligado. Essa 
técnica de declarar uma variável para os pinos e informá-los 
diretamente nos comandos no corpo do programa facilita caso você 
queira mudar o componente externo do pino por qualquer motivo. 
Em vez de ter que procurar pelo código todo para alterar cada uma 
das referências, basta alterar a variável, que estará tudo ok. 


Na função setup() , temos dois ajustes de pinos. Um com 
pinMode(LED_BUILTIN, OUTPUT); , que indica o pino onde está o LED 
embutido ( LED BUILTIN ), é ajustado como saída ( outPuT ), da mesma 
forma que já fizemos na experiência anterior. E pinmode(botao, 

INPUT PULLUP); , em que ajustamos o pino que está na variável botao 
(12) como entrada, inclusive ativando o resistor pull-up existente 
nele. 


Na função 1oop() , lemos a entrada do botão e armazenamos o 
resultado na variável inteiro leitura com a linha int leitura = 
digitalRead(botao); . 


Em seguida, realizamos a seguintes verificações: caso a variável 
leitura tenha o valor Low ( o ), o LED será aceso; caso o valor da 
variável seja HIGH (1 ), o LED deverá apagar. Fazemos tudo isso com 
a estrutura de seleção: 


if(leitura == LOW) { 
digitalwrite(LED BUILTIN, LOW); 
+ else { 


digitalWrite(LED BUILTIN, HIGH); 
} 


O comando if(leitura == Low) verifica se a variável leitura contém o 
valor Low . Se isso for verdadeiro, a linha digitalwrite(LED BUILTIN, 
Low); acenderá o LED embutido. Se for falso, a linha 
digitalwrite(LED BUILTIN, HIGH); apagará o LED embutido. 


Resultado esperado: 


Espera-se que, com esse código-fonte, você aperte o botão e o LED 
acenda, permanecendo aceso enquanto você segurar o botão 
apertado. Soltando o botão, o LED deverá apagar. 


Mas na introdução dessa experiência já nos autodesafiei a mudar o 
comportamento do botão: em vez de acender o LED enquanto 
pressionado, vamos manter o LED ligado depois de o botão ser 
pressionado apenas uma vez. Para apagar, bastará apertá-lo 
novamente. 


Preparado? Vamos mudar um pouco o código anterior: 
Programação: 
int botao = 12; 


void setup() { 
pinMode(LED BUILTIN, OUTPUT); 
pinMode(botao, INPUT PULLUP); 
} 


void loop() { 
int leitura = digitalRead(botao); 
if(leitura == LOW) { 
while(leitura == LOW) { 
leitura = digitalRead(botao); 
delay(50); 


} 
int estado = digitalRead(LED_BUILTIN); 


digitalwrite(LED BUILTIN, lestado); 


} 
} 


O que foi feito: 


A variável no começo e a função setup() são as mesmas, já que a 
montagem e equipamentos usados continuam os mesmos. Vamos 
mudar o comportamento deles. 


A leitura do botão na função 1oop() também é a mesma do código 
anterior, ou seja, até a estrutura de seleção if permanece 
inalterada. Porém, todo o resto mudou, dentro do if temos agora o 
seguinte trecho: 


while(leitura == LOW) { 
leitura = digitalRead(botao); 
delay(50); 


} 
int estado = digitalRead(LED_BUILTIN); 
digitalWrite(LED BUILTIN, !estado); 


Dentro do if(leitura == Low) que verifica se o botão foi pressionado 
lendo Low, nesse caso, foi colocada uma estrutura de repetição 
while(leitura == Low) que identifica se o botão foi mantido 
pressionado. Com isso, evitamos leituras sucessivas, o que causaria 
um funcionamento fora do desejado, fazendo com que o LED 
piscasse rapidamente sem parar, em vez de somente mudá-lo de 
estado (ligado e desligado). 


Se o botão for mantido pressionado, o código ficará preso nesse 
while , repetindo a leitura do estado do botão com a linha leitura = 
digitalRead(botao); até que ele seja solto. Entre cada leitura, 
aguardamos 50 milissegundos com delay(50) . É importante aguardar 
algum tempo para evitar que um "repique" de botão cause uma 
leitura equivocada pelo programa. 


No NodeMCU, assim como no Arduino, podemos ler o estado do 
pino (se HIGH OU Low ) mesmo que ele esteja ajustado como saída. 


Nesse nosso programa fazemos isso com int estado = 
digitalRead(LED BUILTIN); € O resultado da leitura ficará na variável 
estado , que é do tipo inteiro. 


Na sequência, usamos a linha digitalwrite(LED BUILTIN, !estado); para 
mudar o estado do LED. O sinal de exclamação ( ! ) na linguagem C 
indica inversão/negação. Portanto, !estado é O valor da variável 
invertido ou negado, se for HIGH passará a ser Low e vice-versa. 
Assim, se o LED estiver aceso ( Low ), ele apagará já que o pino 
passará a ter valor HIGH . 


Mais uma vez, note que o software tem controle sobre o hardware, 
determinando como qualquer equipamento funciona. Somos nós, 
programadores, que dizemos como as coisas devem funcionar! 


Desafio: 


Tente incluir mais um botão à experiência fazendo com que um ligue 
o LED e o outro desligue. Bastará mudar pouca coisa no segundo 
código demonstrado. 


Se quiser unir essa experiência com a primeira, você poderá criar 
um semáforo que poderá ser controlado por botões na hora de 
fechar ou abrir. Que tal? 


Na próxima experiência... 


... Considerando que você já está familiarizado e estudou bastante o 
funcionamento geral do NodeMCU, percebendo que ele é bem 
parecido com o Arduino na questão de pinos e eletrônica, daqui 
para a frente vamos nos concentrar no que ele tem de especial e 
melhor: a rede WiFi! 


Hora da diversão! 


CAPÍTULO 7 
Experiência nº 03 - Buscando redes sem fio 
próximas 


Vamos começar a explorar a conectividade de rede disponível no 
NodeMCU que se dá por meio de redes sem fio (WiFi). 


A primeira experiência que faremos para isso é uma busca por 
redes sem fio próximas, ou seja, um site survey. O NodeMCU 
pesquisará o espectro WiFi, procurando por redes ao alcance que 
possam ser identificadas, e armazenará o nome da rede, a potência 
do sinal e até o tipo de criptografia utilizado. 


Faremos dois códigos novamente, primeiro com o nome das redes e 
a potência do sinal, e depois incluiremos o tipo de criptografia. 
Assim poderemos entender melhor e com calma cada conceito 
envolvido nesta experiência. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária. Apenas ligue seu NodeMCU ao seu 
computador. 


Programação: 

Hinclude <ESP8266WiFi.h> 

void setup() { 
Serial.begin(9600); 


Serial.println("Iniciando"); 
delay(500); 


Serial.printin("Procurando redes..."); 

int qtde redes = WiFi.scanNetworks(); 

Serial.printin("Redes encontradas:"); 

for (int i = 0; i < qtde redes; i++) { 
Serial.print("Nome da rede...........: "3; 
Serial.printIn(WiFi.SSID(i)); 
Serial.print("Potência do Sinal (dBm): "); 
Serial.printIn(WiFi.RSSI(i)); 
Serial.println("----------------------- "33 


void loop() {} 
O que foi feito: 


O primeiro passo é importar a biblioteca Esps266wiFi.h com a linha 
tinclude <ESP8266WiFi.h> . Essa biblioteca proverá todos os comandos 
e funções necessários para interconexão com redes sem fio. 


Nesta experiência, tudo é feito na função setup() . Isso fará com que 
tudo seja executado apenas uma vez, assim que o NodeMCU for 
ativado. Note que a função 1oop() está vazia. 


Para que possamos acompanhar os resultados da busca por redes 
sem fio, primeiro devemos iniciar a comunicação serial entre o 
NodeMCU e o computador, em uma taxa de transmissão de 9.600 
bauds. Isso é feito com a linha serial .begin(9600); . Na sequência, 
enviamos para o Monitor Serial a mensagem “ Iniciando” com 


Serial.printin("Iniciando");. 


Baud é a medida utilizada para a velocidade de transmissão de 
dados. Tem esse nome em homenagem ao inventor do telégrafo 
Emile Baudot e indica a quantidade de mudanças que podem 
ocorrer no canal de transmissão em um determinado tempo, por 
exemplo, 9.600 bauds indica que o canal de transmissão realizará 
9.600 mudanças em um segundo. No caso, a conexão USB-Serial 
entre o computador e o NodeMCU terá até 9.600 mudanças de 


estado (transmissão de caracteres ou comandos) em um segundo. 
É importante ressaltar que não se deve confundir bps (bits per 
second ou bits por segundo) com bauds. Um comando ou um 
caractere contém vários bits, portanto bauds representará uma 
velocidade de transmissão proporcional, mas não igual ao bps. 


Continuando, com a linha delay(50e); fazemos uma pausa de meio 
segundo (500 milissegundos) e enviamos para o monitor serial a 
mensagem " procurando redes... ", usando a linha 
Serial.printlIn("Procurando redes...");. Fazemos isso para alertar que 
a busca por redes sem fio começará. 


A busca por redes sem fio é feita com a linha int qtde redes = 
WiFi.scanNetworks(); . A função scanNetworks Val procurar todas as 
redes sem fio que estão no alcance da interface de rede e retornará 
um número inteiro representando o número total de redes 
encontradas. Essa mesma função também vai armazenar o nome ( 
ssID ), a potência do sinal ( rss ) e o tipo de criptografia ( 
encryptionType ) de cada uma dessas redes dentro de um vetor que 
pode ser acessado depois pelos seus respectivos métodos. 


Dentro da estrutura de repetição for fazemos um laço que conta de o 
até a quantidade de redes encontradas. Para que você possa 
conferi-las no Monitor Serial, fazemos o envio das informações de 
redes encontradas e potência dos sinais, respectivamente, com as 
linhas Serial.printin(WiFi.SSID(i)); € Serial.printIn(WiFi.RSSI(i));. 


Resultado esperado: 


No Monitor Serial veremos o resultado da busca pelas redes sem fio 
com o nome e a potência do sinal de cada uma que foi encontrada: 











| Enviar 
kSSSLÇS A 
Procurando redes... 

Redes encontradas: 

Nome da rede...........: dae-dproji 

Potencia do Sinal (dBm): -82 

Nome da rede...........: dae-lei 

Potencia do Sinal (dBm): -84 

Nome da rede...........: LopesHouse 

Potencia do Sinal (dBm): -73 

Nome da rede........... : Leticia e Maria Eduarda 

Potencia do Sinal (dBm): -84 

Nome da rede........... : &NET-CLARO-WIFI 

Potencia do Sinal (dBm): -91 

EEVEE ENEAS a ERE v 
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Figura 7.1: Resultado do programa no Monitor Serial 


Como prometido, agora vamos fazer um novo código para incluir o 
tipo de criptografia das redes! Muda pouco. 


Programação: 
#include <ESP8266WiFi.h> 


void setup() { 

Serial.begin(9600); 

Serial.println("Iniciando"); 

delay(500); 

Serial.printlIn("Procurando redes..."); 

int qtde redes = WiFi.scanNetworks(); 

Serial.printin("Redes encontradas:"); 

for (int i = ð; i < qtde redes; i++) { 
Serial.print("Nome da rede...........: "); 
Serial.println(WiFi.SSID(i)); 


Serial.print("Potência do Sinal (dBm): "); 
Serial.printin(WiFi.RSSI(i)); 
Serial.print("Tipo de criptografia...: "); 
String cripto; 
switch(WiFi.encryptionType(i)) 1 
case 2: cripto = "TKIP (WPA)"; break; 
case 4: cripto = "CCMP (WPA)"; break; 


case 5: cripto = "WEP"; break; 

case 7: cripto = "Nenhuma"; break; 

case 8: cripto = "AUTO"; break; 
} 
Serial.println(cripto); 
Serial.println("----------------------- "); 


void loop() {} 
O que foi feito: 


Fazemos exatamente a mesma coisa que no código anterior, porém 
acrescentamos um trecho com uma estrutura de seleção switch para 
verificar a criptografia usada na rede sem fio encontrada: 


String cripto; 
switch(WiFi.encryptionType(i)) { 
case 2: cripto = "TKIP (WPA)"; break; 


case 4: cripto = "CCMP (WPA)"; break; 
case 5: cripto = "WEP"; break; 
case 7: cripto = "Nenhuma"; break; 
case 8: cripto = "AUTO"; break; 

} 


Serial.println(cripto); 


Nesse trecho, declaramos uma variável do tipo string chamada 
cripto , que receberá o tipo de criptografia das redes encontradas. 


Usamos uma estrutura de seleção switch , como já mencionado, 
para selecionar o retorno do comando wiFi.encryptionType(i) , que é 


um valor inteiro representando o tipo de criptografia, sendo que esse 
valor pode ser: 


e 2 para TKIP (WPA) 

4 para CCMP (WPA) 

e 5 para WEP 

e 7 para Nenhuma (rede aberta sem criptografia) 
e 3 para AUTO 


Esses valores são predefinidos pela biblioteca Esps26ewiri , que foi 
importada no início do programa. 


Por fim, enviamos mais essa informação para o Monitor Serial, 
usando Serial.printin(cripto);. 


Resultado esperado: 


Executando o programa os dados das redes sem fio encontradas 
serão mostrados no Monitor Serial, mas agora com o tipo de 
criptografia incluso: 





COM5 





s+See5 

Procurando redes... 
Redes encontradas: 

Nome da rede...........: 
Potencia do Sinal (dBm): 
Tipo de criptografia...: 
Nome da rede...........t 
Potencia do Sinal (dBm): 
Tipo de criptografia...: 
Nome da rede...........: 
Potencia do Sinal (dBm): 
Tipo de criptografia...: 
Nome da rede........... : 
Potencia do Sinal (dBm): 
Tipo de criptografia...: 
Nome da rede...........: 
Potencia do Sinal (dBm): 
Tipo de criptografia...: 
Nome da rede...........: 
Potencia do Sinal (dBm): 
Tipo de criptografia...: 


dae-dproji 
-83 
AUTO 


dae-lei 
-84 


AUTO 


LopesHouse 
-73 
AUTO 


Leticia e Maria Eduarda 
-86 


CCMP (WPA) 


NET_DAE 
-92 
CCMP (WPA) 


ENET-CLARO-WIFI 
-92 
Nenhuma 
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Figura 7.2: Resultado do novo código, agora com a criptografia das redes, no Monitor 


Serial 


Ainda há mais uma coisa que precisamos considerar: como verificar 
o status do módulo WiFi do NodeMCU. É uma boa prática, antes de 
mais nada, verificar se o NodeMCU está com sua capacidade WiFi 
disponível e funcional; caso contrário, emitir algum sinal de erro para 
o operador ou usuário. 


Vamos mudar um pouco nosso programa novamente, para incluir 
essa capacidade. Com isso, o programa e o equipamento em que 


está inserido terá um funcionamento mais seguro e elegante. 
Programação: 
Hinclude <ESP8266WiFi.h> 


void setup() { 

Serial.begin(9600); 

Serial.printlin("Iniciando"); 

delay(500); 

if(WiFi.status() == WL NO SHIELD) { 
Serial.println("Módulo Wifi não está presente!"); 
while(true); 

} 

Serial.println("Procurando redes..."); 

int qtde_redes = WiFi.scanNetworks(); 

Serial.println("Redes encontradas:"); 

for (int i = ð; i < qtde redes; i++) { 
Serial.print("Nome da rede...........: "3; 
Serial.println(WiFi.SSID(i)); 
Serial.print("Potência do Sinal (dBm): "); 
Serial.printin(WiFi.RSSI(i)); 
Serial.print("Tipo de criptografia...: "); 
String cripto; 
switch(WiFi.encryptionType(i)) { 

case 2: cripto = "TKIP (WPA)"; break; 


case 4: cripto = "CCMP (WPA)"; break; 
case 5: cripto = "WEP"; break; 
case 7: cripto = "Nenhuma"; break; 
case 8: cripto = "AUTO"; break; 
} 
Serial.printlin(cripto); 
Serial.println("----------------------- DE 


void loop() {} 


O que foi feito: 


O código é o mesmo que o anterior, inclusive com a criptografia das 
redes, mas antes de começarmos a busca por redes, 
acrescentamos o seguinte trecho: 


if(WiFi.status() == WL NO SHIELD) 1 
Serial.printin("Módulo Wifi não está presente!"); 
while(true); 


} 


Com a linha if(wiFi.status() == WL_NO_SHIELD) , USamos o comando 
WiFi.status() para obter o estado atual do módulo WiFi. Se a 
constante wL No sHIELD for retornada, esse é o indicador de que há 
algum problema com ele. 


Se isso acontecer, emitiremos a mensagem " módulo WiFi não está 
presente " € COM while(true) Causamos um travamento por loop 
infinito, interrompendo a execução do programa em definitivo. 


Nesse caso, em vez de travar o programa, você pode ainda colocar 
alguma luz de advertência para indicar ao operador do equipamento 
que há problemas com o módulo WiFi que precisam ser resolvidos, 
já que o funcionamento do equipamento ficará comprometido sem 
ele. 


As constantes que wifi.status() pode retornar são: 


e WL CONNECTED — quando o módulo está conectado a uma rede 
WiFi; 

e WL NO SHIELD — quando o módulo WiFi não está presente; 

e WL NO SSID AVAIL — quando não há rede disponível 

e WL SCAN COMPLETED — quando a procura por redes sem fio foi 


completada; 

e WL CONNECT FAILED — quando a tentativa de conexão em uma rede 
falhou; 

e WL CONNECTION LOST — quando a conexão de uma rede sem fio for 
perdida; 


e WL DISCONNECTED — quando há a desconexão de uma rede sem fio; 


Resultado esperado: 


Como o módulo WiFi deverá estar em pleno funcionamento, sem 
quaisquer problemas, o resultado da busca por redes sem fio será 











apresentado: 
É coms - O x 
Enviar 
iciando 
Procurando redes... 
Redes encontradas: 
Nome da rede........... : dae-lei 
Potencia do Sinal (dBm): -83 
Tipo de criptografia...: AUTO 
Nome da rede...........: dae-dproji 
Potencia do Sinal (dBm): -88 
Tipo de criptografia...: AUTO 
Nome da rede...........: LopesHouse 
Potencia do Sinal (dBm): -74 
Tipo de criptografia...: AUTO 
Nome da rede...........: luc4s 
Potencia do Sinal (dBm): -66 
Tipo de criptografia...: CCMP (WPA) 
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Figura 7.3: Busca por redes, mas com verificação do estado do módulo WiFi 


Desafio: 


O desafio é criar um código que seja capaz de reconhecer rede sem 
fio sem criptografia e acenda o LED embutido quando isso 
acontecer. Com isso, você criará um "detector de redes sem senha”. 


Quando o LED acender, você sabe que naquele ambiente tem 
alguma rede sem fio que não tem proteção por senha! 


Para resolver esse desafio todas as ferramentas já foram 
apresentadas. Você consegue! 


Na próxima experiência... 


... além de detectar redes sem fio, vamos nos conectar a uma! Em 
frente! 


CAPÍTULO 8 
Experiência nº 04 - Conectando em uma rede 
sem fio 


Chegou a hora de nos conectarmos a uma rede sem fio. Já 
sabemos como procurá-las e, com o nome da rede e sua senha nas 
mãos, podemos nos conectar a uma delas. Esses são os dois 
Únicos pré-requisitos para agora: saber o nome e a senha de uma 
rede sem fio. 


Você pode usar a rede sem fio da sua casa ou do trabalho se tiver 
autorização, ou compartilhar a internet do celular. Basta só o nome e 
a senha. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária. Apenas ligue seu NodeMCU ao seu 
computador. 


Programação: 
Hinclude <ESP8266WiFi.h> 


int tentativas = 50; 
char ssid[] = “iPhone de Fernando Bryan"; 
char senha[] = "biycoj7s5s9cs"; 


void setup() 


{ 
Serial.begin(9600); 


WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 


{ 
delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 
} 
} 


Serial.println("Conectado!"); 
Serial.print("IP.............: "9; 
Serial.printin(WiFi.localIP()); 
Serial.print("Máscara de rede: "); 
Serial.printin(WiFi.subnetMask ()); 
Serial.print("Gateway........: "); 
Serial.printIn(WiFi.gatewayIP()); 


void loop() {} 
O que foi feito: 


Esse será nosso código padrão para conectar em rede sem fio para 
essa e todas as próximas experiências. Dedique-se um pouco mais 
para entendê-lo e sempre que achar necessário volte até aqui para 
consultá-lo. 


Depois da importação da biblioteca Esps26ewiri.h declaramos uma 
variável do tipo inteiro chamada tentativas . Nela, atribuímos o 
número se , que será a quantidade de vezes que ele tentará 
estabelecer uma conexão antes de emitir um erro. Será nosso time- 
out para a conexão com a rede. 


Esse valor pode ser alterado para o que você desejar, mas se for 
muito baixo a chance de obter erro mesmo em uma conexão que iria 


acontecer será grande e, se for muito alto você terá que esperar 
muito para ter a mensagem de erro em caso de insucesso na 
conexão. 


Na sequência, declaramos uma variável como cadeia (vetor) de char 
chamada ssid, com a linha char ssid[] = "iPhone de Fernando Bryan"; . 
Essa variável será onde armazenaremos o nome da rede em que 
vamos no conectar. E logo depois outra cadeia de char chamada 
senha, COM a linha char senha[ |] = "biycoj7s5s9cs";, que contém a 
senha para a conexão na rede escolhida. 


Com a linha wiFi.begin(ssid, senha); O módulo WiFi iniciará o 
procedimento interno para conexão à rede sem fio e o programa 
seguirá sua execução normal. Ou seja, apesar de iniciar a tentativa 
de conexão, essa instrução não bloqueia o código, por isso temos 
que controlar se a conexão aconteceu ou não, e dessa forma 
controlar se a a execução do programa deve continuar ou não. 


Para realizar esse controle, usamos a estrutura de repetição while 
(WiFi.status() != WL CONNECTED) para, enquanto o estado do WiFi não 
for wL CONNECTED, manter o programa em um estado de espera. Para 
não aguardar eternamente por algo que pode não acontecer 
usamos a quantidade de, no máximo, 50 tentativas. Para cada 
repetição aguardamos 500 milissegundos (meio segundo) com 
delay(500) € decrescemos em 1 o número de tentativa com 
tentativas-- . Caso as tentativas cheguem a zero dá-se a mensagem 
de " Time-out " no Monitor Serial e interrompemos forçosamente o 
programa com while(true) . 


Porém, se der tudo certo e a conexão for bem-sucedida usamos 
wiFi.localIP() para saber qual endereço IP foi atribuído ao 
NodeMCU, wiFi.subnetMask() para saber a máscara de sub-rede e 
WiFi.gatewayIP() para saber o endereço IP do gateway da rede em 
que estamos conectados. 


Resultado esperado: 


Carregue seu programa no seu NodeMCU e abra o Serial Monitor. 


A cada ponto que aparecer no Monitor Serial será uma tentativa de 
conexão, e meio segundo terá se passado entre cada uma delas. 
Depois de 50 tentativas, caso não seja possível conectar (a rede 
pode estar desligada, o nome ou a senha errados), você verá a 
mensagem " Time-out. Verifique as configurações e tente novamente i 
como na imagem a seguir: 








Time-out. Verifique as configurações e tente novamente. 
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Figura 8.1: O resultado da experiência no Monitor Serial em conseguir conexão 


Caso seja possível conectar com sucesso, mesmo que sejam 
necessárias algumas tentativas, você terá as informações de IP, 
máscara de rede e gateway que foram atribuídos ao seu NodeMCU: 





Enviar 
Milliacicsissasópdsduasê Conectado! 
IP.......cccc 00: 172.20.10.5 
Máscara de rede: 255.255.255.240 
Gateway........ : 172.20.10.1 
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Figura 8.2: O resultado da experiência no Monitor Serial conexão feita 


Mas você deve estar pensando: ok, conectamos a uma rede, mas e 
se de repente eu sair andando com NodeMCU e ficar longe do 
celular que está compartilhando a internet, do roteador ou do 
Access Point, a conexão vai cair! 


Minha resposta: sim, vai cair e podemos detectar isso. Mas não será 
necessário controlar praticamente nada a partir disso, já que o 
NodeMCU entrará em um estado de reconexão e quando você 
chegar perto da fonte de rede ele conectará de volta. 


Mas vamos fazer um novo código para mostrar isso acontecendo: 
Programação: 


#include <ESP8266WiFi.h> 


int tentativas = 50; 
char ssid[] = “iPhone de Fernando Bryan"; 
char senha[] = "biycoj7s5s9cs"; 


void setup() 


{ 
Serial.begin(9600); 


WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 


} 


Serial.println("Conectado!"); 
Serial.print("IP.............: "); 
Serial.printin(WiFi.localIP()); 
Serial.print("Máscara de rede: "); 
Serial.printin(WiFi.subnetMask ()); 
Serial.print("Gateway........: "); 
Serial.printIn(WiFi.gatewayIP()); 


void loop() { 
if(WiFi.status() == WL CONNECTED) { 
Serial.printin("Rede conectada!"); 
} 
if(WiFi.status() == WL_DISCONNECTED) { 
Serial.println("A rede desconectou!"); 


} 

if(WiFi.status() == WL_NO_SSID_AVAIL) { 
Serial.println("A rede não está mais disponível!"); 

} 


if(WiFi.status() == WL CONNECTION LOST) { 


Serial.println("A conexão foi perdida!"); 


} 
} 


O que foi feito: 


Mudamos apenas a função 1oop() que estava vazia e agora 
colocamos o seguinte trecho de código: 


if(WiFi.status() == WL CONNECTED) 1 
Serial.printin("Rede conectada!"); 


} 
if(WiFi.status() == WL_DISCONNECTED) { 


Serial.println("A rede desconectou!"); 


} 
if(WiFi.status() == WL_NO_SSID_AVAIL) { 
Serial.println("A rede não está mais disponível!"); 


} 
if(WiFi.status() == WL_CONNECTION_LOST) { 


Serial.println("A conexão foi perdida!"); 


} 


Usamos as estruturas de seleção if para verificar o estado do 
módulo WiFi. Relembrando as constantes que wiFi.status() pode 
assumir: 


e WL CONNECTED — quando o módulo está conectado a uma rede 
WiFi; 

e WL NO SHIELD — quando o módulo WiFi não está presente; 

e WL NO SSID AVAIL — quando não há rede disponível 

e WL SCAN COMPLETED — quando a procura por redes sem fio foi 


completada; 

e WL CONNECT FAILED — quando a tentativa de conexão em uma rede 
falhou; 

e WL CONNECTION LOST — quando a conexão de uma rede sem fio for 
perdida; 


e WL DISCONNECTED — quando há a desconexão de uma rede sem fio; 


Dessa forma, podemos ter uma indicação visual no Monitor Serial 
da eventual perda de conexão e reconexão que o NodeMCU fará. 


Resultado esperado: 


Compile e carregue o programa para seu NodeMCU. Primeiro, deixe 
que ele conecte normalmente e você verá no Monitor Serial a 
mensagem " Rede conectada! " ser exibida constantemente. 





COM5 — o x 





Rede conectada! A 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada! 
Rede conectada v 
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Figura 8.3: Mensagem de rede conectada 


Depois, desligue o seu roteador ou o compartilhamento do celular, e 
você verá a mensagem " A rede desconectou! " 





CoMs — o x 





rede desconectou! A 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconectou! 
rede desconect v 


Ed 
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Figura 8.4: Mensagem de rede desconectada 


Depois de alguns segundos emitindo o estado de rede descontada, 
a mensagem que será mostrada será de" A rede não está mais 
disponível! " porque o módulo WiFi não mais encontrará o SSID 
disponível. 





€3 coms 





rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 
rede nao 


e Sr SS SS SS SS 


esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 
esta 


mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 
mais 


disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
disponivel! 
d 
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Então, ligue o roteador ou o compartilhamento do celular novamente 
e você perceberá que o NodeMCU vai reconectar automaticamente 
e voltar a apresentar a mensagem "Rede conectada!" no Monitor 


Serial. 


Figura 8.5: Mensagem de rede indisponível 
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rede nao esta mais disponivel! A 
rede nao esta mais disponivel! 
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rede nao esta mais disponivel! 

rede nao esta mais disponivel! 

rede nao esta mais disponivel! 

rede nao esta mais disponivel! 

rede nao esta mais disponivel! 

rede desconectou! 

rede desconectou! 

rede desconectou! 

rede desconectou! 

rede desconectou! 
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rede desconectou! 

rede desconectou! v 
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Figura 8.6: Primeiro, a indicação de que a rede estava desconectada e, na sequência, a de 
rede conectada normalmente 


Isso mostra a flexibilidade que o NodeMCU nos dá no tratamento a 
conexões de rede sem fio. 


Desafio: 


Mude o código apresentado anteriormente e faça com que o 
NodeMCU automaticamente conecte-se à rede sem fio que esteja 
sem senha. 


Para realizar esse teste você pode usar um roteador que não seja o 
seu doméstico ou empresarial e configurá-lo ora com alguma senha, 
ora sem nenhuma senha. 


Você precisará do que foi mostrado na experiência anterior e nessa, 
basta juntar tudo. 


Força! Coloque a cabeça para funcionar! 
Na próxima experiência... 


... Vamos aprender como informar um endereço IP específico para 
nosso NodeMCU. Em vez de ter que ficar procurando por ele na 
rede, já saberemos o endereço em que ele estará. 


Mãos à obra! 


CAPÍTULO 9 
Experiência nº 05 - Definindo IP fixo para o 
NodeMCU 


Na experiência anterior, conectamos em uma rede sem fio e o 
NodeMCU recebeu um endereço IP através de DHCP - Dynamic 
Host Configuration Protocol ou Protocolo de Configuração Dinâmica 
de Host. Toda vez que um equipamento é ligado e conectado a uma 
rede, caso não tenha configurado um IP fixo, ele envia uma 
requisição solicitando um endereço IP automático. Caso haja um 
servidor DHCP nessa rede, é informado um endereço novo e o 
equipamento é configurado automaticamente nele. 


Isso é muito prático, pois evita que tenhamos que passar por 
centenas de equipamentos em uma rede, por exemplo, 
configurando um endereço IP diferente para cada um deles, isso 
porque se dois equipamentos estiverem configurados com o mesmo 
IP nenhum dos dois conseguirá enviar e receber dados 
corretamente pela rede. 


Mas tem uma desvantagem: no nosso caso, por exemplo, ao 
conectarmos um NodeMCU na rede teremos que dar um jeito de 
saber o IP que ele recebeu. Na experiência anterior mostramos o 
endereço no Monitor Serial, caso contrário teríamos que varrer a 
rede IP por IP até encontrá-lo. Claro que há ferramentas para fazer 
isso automaticamente, mas é sempre um trabalho a mais que 
poderia ter sido simplificado se atribuíssemos um IP específico e 
fixo para o NodeMCU. 


É o que faremos agora. Vamos indicar qual endereço IP queremos 
que o NodeMCU tenha na rede. Lembre-se de que para poder 
acessá-lo esse endereço IP deverá ser um que faça parte da sua 
rede. 


Vamos aproveitar o código fonte de conexão à rede sem fio que já 
fizemos e alterá-lo para a configuração com IP fixo. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária. Apenas ligue seu NodeMCU ao seu 
computador. 


Programação: 
Hinclude <ESP8266WiFi.h> 


int tentativas = 50; 
char ssid[] = “iPhone de Fernando Bryan"; 
char senha[] = "biycoj7s5s9cs"; 


void setup() 


{ 
Serial.begin(9600); 


WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while (true); 
} 


} 
IPAddress ip(172, 20, 10, 3); 
IPAddress dns(8, 8, 8, 8); 


IPAddress gateway(172, 20, 10, 1); 
IPAddress mascara(255, 255, 255, 0); 
wWiFi.config(ip, dns, gateway, mascara); 
Serial.printin("Conectado! "3; 
Serial.print("IP............. Os 
Serial.printin(WiFi.localIP()); 
Serial.print("Máscara de rede: "); 
Serial.printIn(WiFi.subnetMask ()); 
Serial.print("Gateway........: "); 
Serial.printIn(WiFi.gatewayIP()); 


void loop() {} 
O que foi feito: 


De início usamos praticamente todo o código da experiência 
anterior, mas adicionamos o seguinte trecho depois de a conexão 
com a rede estar estabelecida: 


IPAddress ip(172, 20, 10, 3); 

IPAddress dns(8, 8, 8, 8); 

IPAddress gateway(172, 20, 10, 1); 
IPAddress mascara(255, 255, 255, 0); 
WiFi.config(ip, dns, gateway, mascara); 


O tipo de dado 1PAddress é específico para declarar variáveis que 
guardarão endereços IPs, pois são um vetor ( array ) com quatro 
octetos (conjuntos de oito bits) que armazenam cada trecho do 
endereço. 


Sendo assim criamos quatro variáveis que são endereços IPs: 


e ip— é o endereço IP que será usado pelo NodeMCU, nesse 
caso 172.20.10.83; 

e dns — é O endereço do servidor DNS para resolução de nomes 
na internet, nesse caso usamos um do Google; 

e gateway — é O endereço do roteador. Quando o NodeMCU 
mandar algum pacote endereçado para qualquer lugar que não 


seja a rede local, ele será tratado pelo equipamento neste 
endereço; 
e mascara — é a máscara de sub-rede, no caso 255.255.255.0. 


O comando WiFi.config(ip, dns, gateway, mascara) efetua a 
configuração, informando ao NodeMCU o IP, DNS, gateway e 
máscara de sub-rede que devem ser utilizados. 


Lembre-se de colocar endereços que façam parte da sua rede sem 
fio. 


Note que fazemos a atribuição do endereço IP fixo depois de 
conectados à rede sem fio. Isso fará com que o NodeMCU se 
comporte obtendo um IP dinâmico por DHCP da própria rede, caso 
esse serviço esteja disponível, e depois ajustando para a 
configuração fixa informada. 


Resultado esperado: 


Compile e carregue seu código em seu NodeMCU. Abra o Monitor 
Serial e você verá as configurações de IP, que devem ser as 
informadas pelo comando wiFi.config . 
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Figura 9.1: Monitor Serial com as configurações informadas 


Agora usando um computador na mesma rede vamos usar o 
comando ping para verificar se o NodeMCU pode ser encontrado na 
rede - no caso desse código podemos usar ping 172.280.10.3 . 


cmd - Atalho — O X 


iiHindowsiSystem32>ping 172.26.18.3 


«3 com 32 bytes de dados: 


do Ping para 172.270.10.3: 
s: Enviados = 4, Recebidos = 4, Perdidos = & (8% de 
A ED 
Aproximar um número redondo de vezes em milissegundos: 
Minimo = 3ms, Máximo = Bms, Média = 4ms 


PH \Hindowsi Syst em32> m 





Figura 9.2: Testando a conexão com o NodeMCU através do comando ping 
Desafio: 


Faça alguns testes usando endereços IPs diferentes para verificar a 
conectividade em sua rede. Também é interessante usar máscaras 
de sub-rede diferentes combinando-as com endereços de IP 
diferentes e testar se o NodeMCU pode ou não ser encontrado pelo 
comando ping . No caso do código apresentado anteriormente, tenho 
algumas sugestões: 


e |P 172.20.0.3 COM a máscara 255.255.0.0 
e |P 172.20.0.3 COM a máscara 255.255.255.0 


Na próxima experiência... 


... vamos adicionar a capacidade de o NodeMCU conectar-se em 
várias redes sem fio predefinidas. Siga em frente, há muito o que 
fazer! 


CAPÍTULO 10 
Experiência nº 06 — Conectando em várias redes 
sem fio 


Vamos a uma situação de exemplo: você pode criar algum 
equipamento utilizando o NodeMCU que depende de rede sem fio 
para enviar dados para algum sistema, mas deseja que ele não 
fique vinculado a apenas uma rede sem fio. 


Há diversas maneiras de resolver essa questão, mas duas podem 
se destacar: a primeira seria incluir nomes e senhas de redes sem 
fio em algumas variáveis, ou para ficar mais elegante em um vetor 
(array), e por meio de uma estrutura de repetição tentar conectar em 
cada uma delas até conseguir conectar a alguma; a segunda seria 
usar a capacidade do NodeMCU de realizar todo esse processo 
automaticamente. 


Claro que a segunda é mais prática e fácil! Em vez de termos que 
criar um vetor para colocar nomes de redes e senhas, podemos 
declarar isso dentro de comandos específicos e deixar que o 
NodeMCU cuide do resto. Quando ele encontrar alguma das redes 
informadas, ele realizará a conexão e, caso encontre mais de uma 
ao mesmo tempo, ele vai se conectar aquela que apresentar a maior 
potência de sinal. 


Isso pode ser especialmente útil, por exemplo, em algum 
equipamento que seja móvel que possa transitar por diversas redes 
sem fio, conhecidas e predeterminadas, sem interromper a 
transmissão de dados. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária. Apenas ligue seu NodeMCU ao seu 
computador. 


Programação: 


tinclude <ESP8266WiFi.h> 
tinclude <ESP8266WiFiMulti.h> 


int tentativas = 50; 
ESP8266WiFiMulti redes; 


void setup() 
{ 
Serial.begin(9600); 
redes .addAP( "iPhone de Fernando Bryan","biycoj7s5s9cs"); 
redes .addAP("Rede de Fernando", "Xx*23tw 77120"); 
redes .addAP("Rede do Trabalho","7762-8901+837"); 


Serial.print("Conectando..."); 
while (redes.run() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while (true); 


} 
} 
Serial.println("Conectado!"); 
Serial.print("REDE...........: "); 
Serial.printIn(WiFi.SSID()); 
Serial.print("IP.............2 "9; 


Serial.printin(WiFi.localIP()); 
Serial.print("Máscara de rede: "3; 
Serial.printin(WiFi.subnetMask ()); 


Serial.print("Gateway........: "); 
Serial.printIn(WiFi.gatewayIP()); 
} 


void loop() {} 
O que foi feito: 


O jeito para conectar-se à rede muda, mas a mecânica para verificar 
se a conexão está feita e mostrar os dados da conexão no Monitor 
Serial continua praticamente a mesma das experiências anteriores. 


As bibliotecas EsP8266wiFi.h € ESP8266WiFiMulti.h fornecerão os 
comandos e funções específicos para que possamos nos conectar 
às redes sem fio e controlar conexões a múltiplas redes, 
respectivamente. Elas são importadas pelas linhas #include 
<ESP8266WiFi.h> O #include <ESP8266WiFiMulti.h>. 


A variável tentativas , declarada com int tentativas = so, terá a já 
conhecida funcionalidade de determinar a quantidade de tentativas 
de conexão à rede sem fio antes de emitir algum erro. Todo caso 
vale a pena dar uma olhada na Experiência nº 04 — Conectando em 
uma rede sem fio. 


Com Esp8266wiFiMulti redes declaramos um objeto chamado redes do 
tipo Esps266wiFimulti . Esse objeto terá vários métodos necessários 
para definirmos as redes sem fio em que será possível conectar. 
Essa definição de redes acontece no seguinte trecho: 


redes .addAP("iPhone de Fernando Bryan","biycoj7s5s9cs"); 
redes .addAP("Rede de Fernando", "Xx*23tw 77120"); 
redes .addAP("Rede do Trabalho","7762-8901+837"); 


A cada redes. addap( nome da rede , senha da rede ) incluímos os 
dados de uma rede sem fio diferente em que o NodeMCU poderá se 
conectar quando a encontrar. Nesse código-fonte incluímos 3 redes. 


Na estrutura while(redes.run() != WL CONNECTED) executamos redes.run() 
, Que comanda a tentativa de conexão às redes informadas. Para 


cada rede, toda vez que o resultado não for wL connEcTED OCOrrerão 50 
tentativas de conexão, isso está definido na variável tentativas, 
antes de ir para a próxima rede. 


Nesse caso em específico, 50 vezes talvez seja muito e deixe a 
transmissão de dados muito lenta, pela desconexão e reconexão em 
uma nova rede. Se colocarmos um número muito baixo talvez não 
dê tempo de a conexão ser estabelecida caso a rede esteja 
disponível, mas um número muito alto poderia gerar tentativas 
excessivas e, se a rede não estiver disponível, o programa poderá 
ficar esperando por uma conexão inutilmente. Será preciso 
encontrar um número ideal para cada tipo de aplicação. 


O trecho a seguir, exceto pelo redes.run() , já foi discutido nas 
experiências anteriores: 


while(redes.run() != WL CONNECTED) 
{ 
delay(500); 
Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while (true); 
} 
} 


Uma vez conectado, resta-nos mostrar no Monitor Serial os dados 
da conexão, que é feito no trecho a seguir: 


Serial.println("Conectado!"); 


Serial.print("REDE...........: "); 
Serial.printIn(WiFi.SSID()); 
Serial.print("IP.............2 "9; 


Serial.printin(WiFi.localIP()); 
Serial.print("Máscara de rede: "); 
Serial.printin(WiFi.subnetMask ()); 


Serial.print("Gateway........: "); 
Serial.printIn(WiFi.gatewayIP()); 


Mostramos o SSID da rede conectada, o endereço IP, a máscara de 
rede e o gateway obtidos automaticamente do roteador ou do 
servidor DHCP. 


Resultado esperado: 


Compilando e carregando o código no NodeMCU, abra o Monitor 
Serial. Você verá as informações de conexão do ponto de acesso 
mais próximo e disponível. 
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Figura 10.1: Dados da conexão 


Se você reiniciar seu NodeMCU e estiver perto de outro ponto de 
acesso pré-cadastrado você verá os dados da nova conexão. 
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Figura 10.2: Dados da nova conexão 


Mas há um pequeno problema nesse código: se você se 
movimentar com o NodeMCU, ele não mudará de ponto de acesso 
automaticamente. Isso acontece porque colocamos a mecânica de 
conexão na função setup() , que é executada apenas uma vez, logo 
depois de o NodeMCU ser ligado. Para que você se mova 
livremente e ele vá se conectando às redes cadastradas que 
encontrar será preciso mover o seguinte trecho para a função 1o0p() 
, Que é executada continuamente enquanto o NodeMCU estiver 
ligado: 


while(redes.run() != WL CONNECTED) 
{ 
delay(500); 
Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while (true); 


} 
} 


Para que o resultado fique mais apresentável e possamos ainda ver 
no Monitor Serial dados da conexão, além de mudar a conexão para 
a função 1oop() foi introduzido um controle que verifica se o 
NodeMCU está ou não conectado. 


Programação: 


tinclude <ESP8266WiFi.h> 
tinclude <ESP8266WiFiMulti.h> 


int tentativas = 50; 
ESP8266WiFiMulti redes; 


void setup() 


{ 
Serial.begin(9600); 
redes .addAP("iPhone de Fernando Bryan", "biycoj7s5s9cs"); 
redes .addAP("Rede de Fernando", "Xx*23tw 77120"); 
redes .addAP("Rede do Trabalho", "7762-8901+837"); 
} 
int ctrl; 


void loop() { 
while (redes.run() != WL_CONNECTED) 
{ 
ctrl = 1; 
delay(500); 
Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
ctrl = ð; 


if (ctrl == 1) { 
Serial.printlin("Conectado!"); 


Serial.print("REDE...........: "9; 
Serial.printin(WiFi.SSID()); 
Serial.print("IP.............7 "3; 


Serial.printin(WiFi.localIP()); 
Serial.print("Máscara de rede: "); 
Serial.printin(WiFi.subnetMask ()); 


Serial.print("Gateway........: "); 
Serial.printlin(WiFi.gatewayIP()); 
ctrl = ð; 

} 


} 
O que foi feito: 


Criamos a variável ctrl que controlará o fluxo do que deverá ser 
mostrado no Monitor Serial. 


Logo que a tentativa de conexão começa, depois de while 
(redes.run() != WL CONNECTED) ela receberá o valor 1. Se a conexão 
não acontecer e ocorrer O time-out , ela receberá o valor o. 


Caso ela contenha o valor 1, significa que a conexão aconteceu, 
então os dados da conexão devem ser enviados para o Monitor 
Serial. Caso contrário, a conexão não aconteceu e nada será 
mostrado até que aconteça. 


Resultado esperado: 


Carregue o código-fonte compilado em seu NodeMCU e você 
poderá monitorar as conexões através do Monitor Serial. 
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Figura 10.3: Dados da conexão 


Desafio: 


Você pode construir um radar de amigos: usando um LED verde, 
você pode cadastrar o compartilhamento de internet dos celulares 
de seus amigos e, quando essas redes forem detectadas e o 
NodeMCU conectar-se a elas, poderá acender o LED mostrando 
que há algum amigo nas proximidades. Que tal? 


Na próxima experiência... 


... vamos criar um servidor web no NodeMCU! Ele hospedará 
páginas que poderão mostrar dados ou mesmo realizar tarefas e 
comandos. 


Vamos em frente! 


CAPÍTULO 11 
Experiência nº 07 - Criando um servidor Web em 
seu NodeMCU 


Vamos continuar usando o compartilhamento de internet do celular 
para acessar o NodeMCU como servidor Web. Se achar melhor, 
podemos usar seu computador, mas apenas caso ele esteja 
conectado à mesma rede sem fio que o NodeMCU. 


Basta que você abra o seu navegador de preferência e acesse o 
endereço IP do NodeMCU que será mostrado no Monitor Serial. 


Com isso, teremos percorrido a maior parte do caminho para 
começar a obter dados de sensores e mostrá-los de uma forma 
amigável. Também poderemos controlar equipamentos externos que 
estejam conectados ao NodeMCU conforme ações que poderemos 
tomar através de páginas Web. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária. Apenas ligue seu NodeMCU ao seu 
computador. 


Programação: 
tinclude <ESP8266WiFi.h> 
tinclude <WiFiClient.h> 


tinclude <ESP8266WebServer.h> 


ESP8266WebServer servidor(80); 


int tentativas = 50; 


String pagina = ""; 
char ssid[] = “iPhone de Fernando Bryan"; 
char senha[] = "biycoj7s5s9cs"; 


void setup(void)( 
pagina = "<html>" 
"<head>" 
"<title>Hello Worldl</title>" 
"</head>" 
"<body>" 
"<hi>Minha primeira página web.</h1>" 
"</body>" 
“e html>; 


Serial.begin(9600); 
WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 
} 


} 
Serial.println(); 


Serial.print("Conectado em "5; 
Serial.println(ssid); 

Serial.print ("Meu endereço IP = "3; 
Serial.printin(WiFi.localIP()); 


servidor.on("/", TIO( 
servidor.send(200, "text/html", pagina); 
}); 
servidor .begin(); 
Serial.println("Servidor WEB iniciado!"); 


void loop(void)f 
servidor .handleClient(); 


} 
O que foi feito: 


Primeiro, importamos 3 bibliotecas do ESP8266: Esp8266wiFi.h , que 
fornece todas as funcionalidades para conectarmos a uma rede sem 
fiO; wiFiClient.h , que fornece métodos para que seja possível 
estabelecer e manter conexões à rede; e ESP8266WebServer.h , que 
trará todas as ferramentas, funcionalidades e métodos para a 
criação e fornecimento de um servidor Web no NodeMCU. 


A segunda coisa a ser feita é criar um objeto chamado servidor a 
partir da classe Espg266Werbserver . O parâmetro passado em 
ESP8266WebServer servidor(80) é a porta TCP/IP a cujas requisições o 
servidor Web vai responder. Aqui no caso é a porta so , padrão para 
aplicações Web. 


Você perceberá que, na função setup() , a conexão à rede sem fio é 
a mesma de todas as experiências anteriores, mas ainda ali 

declaramos uma variável do tipo string chamada pagina , que recebe 
a página Web que será enviada ao cliente Web (navegador), que é: 


pagina = "<html>" 
"<head>" 
"<title>Hello Worldl</title>" 
"</head>" 
"<body>" 
“<hi>Minha primeira página web.</h1>" 
"</body>" 
"</html>"; 


Logo depois de tudo conectado e OK, mandamos ao Monitor Serial 
o nome da rede em que estamos conectado, o endereço IP obtido 
para essa conexão e a mensagem de " Servidor WEB iniciado! " 
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Figura 11.1: Mensagens no Monitor Serial depois de o NodeMCU estar conectado à rede 
sem fio 


Agora que vem a grande novidade e a parte mais importante de 
todo o código desta experiência, as linhas: 


servidor.on("/", TIO( 
servidor.send(200, "text/html", pagina); 


}); 


servidor .begin(); 
Vamos detalhá-las. 


Com servidor.on("/", []O{ , estamos dizendo que, quando o servidor 
receber uma requisição no diretório / , ou seja, quando o endereço 
for nttp://172.20.10.5/, NO Nosso caso, serão enviados ao cliente o 
código HTTP 200 , que é ok , O tipo de resposta será text/HTML e, 
finalmente, o conteúdo da variável pagina . Dessa forma o navegador 


receberá o código HTML e montará a página para o usuário, que é 
mostrada no resultado esperado dessa experiência. 


Resultado esperado: 


Faça upload desse programa ao seu NodeMCU. Abra o Monitor 
Serial para saber qual 1p você recebeu da sua rede. Abra o 
navegador de internet e digite nttp:// seguido do endereço do 
NodeMCU. Você deverá ver um resultado como na imagem a 
seguir: 


172.20.10.5 


Minha primeira pagina web. 


E 


Figura 11.2: A página constante no NodeMCU em um navegador 
Desafio: 


Mude o código HTML da página constante no NodeMCU para que 
tenha link para outras páginas da internet. Note que é possível 
redirecionar o usuário normalmente assim como uma página Web 
comum. 


Na próxima experiência... 


.. que tal controlar um LED através da página Web do NodeMCU? 
E o que faremos na próxima experiência. 


CAPÍTULO 12 
Experiência nº 08 - Controlando um LED através 
de uma página Web 


Chegamos praticamente ao ápice, o ponto central para 
conseguirmos desenvolver programas para NodeMCU e atuar na 
loT! Controlando um LED, entenderemos como controlar 
praticamente tudo: um motor, uma lâmpada, um portão, uma 
cafeteria, entre várias outras coisas. Claro que será necessário, 
nesses casos, criar uma interface adequada usando contatores, 
relês etc. 


Usaremos o LED embutido para essa experiência, mas com a placa 
de ensaios, um resistor, um LED comum e um par de cabinhos você 
consegue fazer o mesmo com um LED externo. 


Essa experiência usa praticamente tudo da experiência anterior para 
criar o servidor Web. Mudaremos apenas a página Web que será 
apresentada ao usuário. A forma de tratar as entradas também será 
similar: enquanto tínhamos um entrada possível ( / ) na experiência 
anterior, aqui teremos mais duas, uma para ligar o LED e outra para 
desligá-lo. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária. Apenas ligue seu NodeMCU ao seu 
computador. 


Programação: 


tinclude <ESP8266WiFi.h> 
tinclude <WiFiClient.h> 
tinclude <ESP8266WebServer.h> 


ESP8266WebServer servidor(80); 


int tentativas = 50; 
String pagina = ""; 
char ssid[] = “iPhone de Fernando Bryan"; 


char senha[] = "biycoj7s5s9cs"; 


void setup(void)( 
pagina = "<html>" 
"<head>" 
"<title>Controla LED</title>" 
"</head>" 
"<body>" 
"<hi>Clique nos botões para ligar/desligar o LED</h1> 
"<p><a href='on'><button>LIGAR</button></a></p>" 
"<p><a href='off'><button>DESLIGAR</button></a></p>" 
"</body>" 
"</html>"; 
pinMode(LED_BUILTIN, OUTPUT); 
Serial.begin(9600); 
WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 


} 
Serial.println(); 


Serial.print("Conectado em "3; 
Serial.println(ssid); 


Serial.print("Meu endereço IP = "3; 
Serial.printin(WiFi.localIP()); 


servidor.on("/", TIO( 
servidor.send(200, "text/html", pagina); 


}); 

servidor.on("/on", TIO 
servidor.send(200, "text/html", pagina); 
digitalwrite(LED BUILTIN, LOW); 
delay(500); 


}); 

servidor.on("/off", []O( 
servidor.send(200, "text/html", pagina); 
digitalwrite(LED BUILTIN, HIGH); 
delay(500); 


}); 
servidor .begin(); 
Serial.println("Servidor WEB iniciado!"); 


void loop(void){ 
servidor .handleClient(); 


} 
O que foi feito: 


Aqui, vamos nos debruçar apenas nas partes específicas do código 
que são diferentes da experiência anterior. Se achar necessário, 
volte até lá para dar uma relembrada. 


Resumidamente: sempre no começo importamos as bibliotecas e 
iniciamos algumas variáveis que nos apoiarão durante todo o 
programa. Entre elas, o nome da rede, a senha para acessá-la e o 
contador de time-out para a conexão. 


Na função setup() , ajustamos tudo e deixamos a conexão feita. 
Também é uma ótima iniciativa começar a comunicação serial com o 
computador e usá-la para exibir mensagens que nos indique que 
está tudo indo bem, como uma forma de depuração do programa. 


Ainda na função setup() , na variável do tipo string chamada pagina, 
colocamos a página Web que vamos mostrar aos clientes que se 
conectarem ao NodeMCU: 


pagina = "<html>" 

"<head>" 
"<title>Controla LED</title>" 

"</head>" 

"<body>" 
"<hi>Clique nos botoes para ligar/desligar o LED</h1>" 
"<p><a href='on'><button>LIGAR</button></a></p>" 
"<p><a href='off'><button>DESLIGAR</button></a></p>" 

"</body>" 

"</html>"; 


A página é um HTML com poucas coisas: apenas um título ( controla 
LED ); No corpo, um texto formatado como cabeçalho ( clique nos 
botões para ligar/desligar o LED ); e dois botões, um LIGAR € outro 
DESLIGAR . 


Os botões levam a endereços distintos. O botão LIGAR levará a um 
endereço terminado em /on formado em conjunto com o IP recebido 
para a conexão. Para esse exemplo, no meu caso, será 
http://172.20.10.5/0n . Note que quando você executar poderá 
receber um endereço IP completamente diferente, por isso a 
importância de ter alguma saída no Monitor Serial para poder 
verificar isso. 


O botão DesLIGAR levará a um endereço terminado em /off . Como já 
explicado, por exemplo, poderá ficar como http://172.20.10.5/0ff . 


O servidor Web do NodeMCU receberá a requisição para esses 
endereços e os tratará da seguinte maneira: 


Quando receber requisição diretamente para o endereço raiz, ou 
seja, seguindo ainda o mesmo exemplo, nttp://172.20.10.5/, ele vai 
executar o seguinte trecho do código: 


servidor.on("/", []IO( 
servidor.send(200, "text/html", pagina); 


}); 


O servidor responderá com um código HTTP 200 ( ok ), informará que 
o resultado será um texto no formato HTML e, por fim, enviará o 
conteúdo da variável pagina . 


Quando receber o endereço terminado em /on , é a parte do código 
a seguir que vai cuidar dessa requisição: 


servidor.on("/on", TIO( 
servidor.send(200, "text/html", pagina); 
digitalwrite(LED BUILTIN, LOW); 
delay(500); 


}); 


Aqui, ele também responderá com um código HTTP 2əe (ox ), 
informará que o resultado será um texto no formato HTML e, por fim, 
enviará o conteúdo da variável pagina . Ou seja, ele vai devolver a 
mesma página, mas adicionalmente executará 

digitalwrite(LED BUILTIN, LOW) para acender o LED embutido e 
delay(500) para aguardar meio segundo (500 milissegundos) antes 
de continuar. A pausa é apenas por conveniência. 


Agora, finalmente, quando receber o endereço terminado em /off , 
será a vez de o código a seguir cuidar dessa requisição: 


servidor.on("/off", [101 
servidor.send(200, "text/html", pagina); 
digitalwrite(LED BUILTIN, HIGH); 
delay(500); 


}); 


Esse trecho comporta-se como o anterior, ou seja, responderá com 
um código HTTP 200 ( ok ), informará que o resultado será um texto 
no formato HTML e, por fim, enviará o conteúdo da variável pagina . 
Na sequência, também executará digitalwrite(LED BUILTIN,HIGH) para 
apagar o LED embutido e delay(500) para aguardar meio segundo 


(500 milissegundos) antes de continuar. A pausa, novamente, é 
apenas por conveniência. 


Já na função 1oop() , temos apenas o código servidor .handleclient() , 
que mantém o NodeMCU aguardando conexões e, caso elas 
aconteçam, dispara o resultado correto e esperado para cada uma. 


Resultado esperado: 


Depois de compilar e enviar o código no seu NodeMCU, acesse-o a 
partir de um navegador para Web. Se ele estiver conectado ao seu 
roteador você poderá usar seu computador para isso. Se ele estiver 
conectado ao compartilhamento de internet do seu celular, use o 
próprio celular para esse acesso. 


Você deverá ver a seguinte página: 


17/2.20.10.5 


Clique nos botoes para ligar/desligar o LED 


Eno a 


Figura 12.1: Página exibida pelo NodeMCU possibilitando acender e apagar o LED 
embutido 


Pressione o botão LIGAR e o LED embutido do NodeMCU deverá 
acender. Pressionando o botão DestiGar O LED deverá apagar. 


Note o endereço que é mostrado na barra de endereço do seu 
navegador: para acender o LED terá final /on e para apagar, /of*. 
Se você acessá-los diretamente, as ações com o LED vão 
acontecer sem que você precise clicar nos botões. 


Essa é uma dica importante, pois você poderá então substituir os 
botões por links ou qualquer outra coisa que leve a esses endereços 
para realizar as ações que deseja. 


Desafio: 


Acender um LED externo, destrancar uma porta, controlar uma 
lâmpada, criar um carrinho controlado pelo celular! O céu é o limite 
agora! 


Tente construir alguma dessas ideias, ou qualquer outra que lhe 
venha à cabeça. Passe um tempo maior explorando esta 
experiência e você verá que o mundo loT está finalmente aberto! 


Na próxima experiência... 


... teremos ainda mais algumas coisas para entender e trabalhar, 
vamos em frente! Vamos realizar uma experiência onde será 
possível ler o conteúdo de uma página Web e realizar tarefas a 
partir do que for lido. 


CAPÍTULO 13 
Experiência nº 09 - Lendo o conteúdo de uma 
página Web 


Imagine que você tem um equipamento controlado por um 
NodeMCU, para o qual você precisa enviar comandos para que ele 
faça alguma tarefa específica. 


Você poderá fazer isso disponibilizando um arquivo na Web, que o 
NodeMCU pode acessar em um determinado intervalo de tempo e, 
caso encontre um comando específico, que pode ser de um 
caractere até várias linhas de texto, ele toma a ação 
correspondente. 


Nesta experiência vamos conectar a uma rede sem fio e acessar 
uma página Web remota, que, como já dito, também pode ser 
apenas um arquivo disponibilizado na internet em algum servidor 
Web, e vamos ver como reagir a esse conteúdo. 


Primeiro, vamos apenas ler a página, depois incrementaremos o 
código para reagir ao seu conteúdo. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária. Apenas ligue seu NodeMCU ao seu 
computador. 


Programação: 


tinclude <ESP8266WiFi.h> 
tinclude <ESP8266HTTPClient.h> 


int tentativas = 50; 

char ssid[] = “iPhone de Fernando Bryan"; 
char senha[] = "biycoj7s5s9cs"; 

IPAddress servidor(74,125,115,105); 
WiFiClient cliente; 


void setup() 


{ 
Serial.begin(9600); 
WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 
} 
} 


Serial.println("Conectado!"); 

Serial.printin("Pagina lida:"); 

HTTPClient http; 

http.begin("http://seucurso.online/teste.php"); 

int codigoHTTP = http.GET(); 

if(codigoHTTP == 200) { 
Serial.printin(http.getString()); 

} 


WiFi.disconnect(); 


void loop() {} 


O que foi feito: 


Depois do trecho de conexão, que está logo a seguir e foi discutido 
na experiência anterior: 


WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 


} 
} 


Serial.println("Conectado!"); 


Usamos a linha HTTPClient http; para criar um objeto HTTPClient 
chamado http . Essa classe vem da biblioteca Esps266HTTPClient.h 
importada no início do código. Com ele, teremos todos os métodos 
(funções) necessários para nos conectarmos a qualquer coisa via 
protocolo HTTP. 


Com http.begin("http://seucurso.online/teste.php"); solicitamos uma 
conexão à página teste. php , que está no domínio seucurso.online . 
Essa página foi escrita na linguagem PHP e tem o seguinte código: 


<?php 
echo date('s'); 
?> 


Esse código fará com que o PHP gere como resultado os segundos 
da hora atual do servidor em que está hospedado. A cada acesso os 
segundos mostrados mudarão. Com isso, temos um dado que seja 
variável que poderemos trabalhar a seguir, ainda nessa experiência. 


Depois de realizar a conexão no endereço remoto, usamos a linha 
int codigoHTTP = http.GET(); para obter o código de retorno do servidor 


Web. Os códigos retornados poderão ser vários, dentre os mais 
comuns estão: 


Código Nome Descrição 


A requisição foi feita com sucesso e a 
entidade correspondente ao recurso 


200 OK o 
requisitado foi enviada como 
resposta. 
A requisição não pôde ser respondida 

400 Bad request porque não foi entendida por má 
formação. 
Para ser obtida, a requisição 

401 Unauthorized precisará de autenticação (usuário e 
senha) 

404 Not Found O recurso solicitado não foi 
encontrado no servidor. 

500 Internal O servidor está com problema e não 


Server Error pode responder à requisição. 


Você pode consultar todos os códigos de respostas HTTP no 
endereço https://www.rfc-editor.org/rfc/rfc2616.txt. 


Com esse código na mão, podemos decidir o que fazer. No caso de 
nosso código com a estrutura de seleção if(codigoHTTP == 200), 
verificamos se a resposta do servidor foi ox e, caso tenha sido, 
procedemos com a leitura da página. 


A leitura da página acontece com http.getstring() , que está dentro 
de um serial.printIn(); para que seja mostrado no Monitor Serial. 


Não custa lembrar de que, no nosso caso, teremos sempre como 
resultado dessa leitura um número correspondente aos segundos da 
hora atual no servidor Web onde a página está hospedada. 


Finalmente, introduzimos o código wiFi.disconnect(); para encerrar a 
conexão WiFi. Se estiver usando o compartilhamento de internet do 
celular, isso será bastante útil, pois encerrará qualquer conexão que 
possa consumir seu pacote de dados. 


Resultado esperado: 


Compile e carregue o código em seu NodeMCU e abra o Monitor 
Serial. Dando tudo certo, você deverá ter a mensagem de que a 
conexão com a rede foi feita e que a página foi lida. Logo na 
sequência você verá um número, que é a resposta da página 
teste.php , como na imagem a seguir. 
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Figura 13.1: Mensagem de conexão OK e informação da página web lida 


Note que, como já foi mencionado logo no começo dessa 
experiência, podemos reconhecer o resultado da página ou arquivo 
remoto e tomar alguma decisão. 


Vamos mover a conexão à página e a leitura do seu conteúdo para 
a função 1oop() e controlar o LED embutido conforme os segundos 
vão passando. Siga o código-fonte a seguir. 


Programação: 


tinclude <ESP8266WiFi.h> 
tinclude <ESP8266HTTPClient.h> 


int tentativas = 50; 

char ssid[] = “iPhone de Fernando Bryan"; 
char senha[] = "biycoj7s5s9cs"; 

IPAddress servidor(74,125,115,105); 
WiFiClient cliente; 


void setup() 

{ 
pinMode(LED_BUILTIN, OUTPUT); 
Serial.begin(9600); 
WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != NL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 
} 
} 


Serial.println("Conectado!"); 
Serial.println("Pagina lida:"); 
} 


void loop() { 
HTTPClient http; 
http.begin("http://seucurso.online/teste.php"); 


int codigoHTTP = http.GET(); 
if(codigoHTTP == 200) { 
String retorno = http.getString(); 
if((retorno.toInt() > 50) && (retorno.toInt() < 59)) { 
digitalNrite(LED BUILTIN, !digitalRead(LED BUILTIN)); 
Serial.printin(retorno); 
} 
} 
} 


O que foi feito: 


O código é o mesmo da experiência anterior, mudamos apenas a 
leitura da página Web da função setup() para a função 1o0p() . 


void loop() { 
HTTPClient http; 
http.begin("http://seucurso.online/teste.php"); 
int codigoHTTP = http.GET(); 
if(codigoHTTP == 200) { 
String retorno = http.getString(); 
if((retorno.toInt() > 50) && (retorno.toInt() < 59)) { 
digitalWrite(LED BUILTIN, !digitalRead(LED BUILTIN)); 
Serial.printin(retorno); 


} 
} 
} 


Com isso, a cada laço de execução do programa, nós lemos a 
página teste.php dO endereço http://seucurso.online/ com a linha 
http.begin("http://seucurso.online/teste.php");. 


Depois de pegar o código de retorno HTTP com int codigoHTTP = 
http.GET(); Verificamos se ele é um sinal de que está tudo ox ( 200 ), 
com O if(codigoHTTP == 200). 


Dentro desse if, criamos uma variável do tipo string chamada 
retorno , que receberá o que for lido do endereço remoto com 
http.getString(); . 


Na sequência, usamos uma estrutura de seleção if((retorno.toInt() 
> 50) && (retorno.toInt() < 59)) que fará com que o LED embutido 
pisque e a string lida seja enviada para o Monitor Serial somente se 
o valor lido estiver entre 51 (> se ) e 58 ( <59 ). O método tornt() 
converte a string lida em retorno em um valor inteiro. 


A linha digitalwrite(LED BUILTIN, !digitalRead(LED BUILTIN)); faz com que 
seja enviado para o LED embutido o inverso (! ) do que for lido no 
pino dele com digitalRead(LED BUILTIN) . 


Resultado esperado: 


Depois de compilar e carregar o código no NodeMCU, abra o 
Monitor Serial. Você verá a mensagem de conexão à rede e de 
página lida e terá que aguardar até que os dados sejam mostrados, 
porque condicionamos que somente quando os números forem 
maiores que 59 e menores que 59 é que serão mostrados. 


Note que quando os números estão nesse intervalo o LED embutido 
também piscará. 
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Figura 13.2: Monitor Serial com o que foi lido entre os segundos 51 e 58 enquanto o LED 
pisca 


Desafio: 


Imagine criar uma página Web onde o usuário possa escolher um 
valor e, a partir dele, acender um LED específico conectado ao 
NodeMCU. Por exemplo, caso ele clique no número 1 um LED 
vermelho acende, caso clique no número 2 um LED verde acende. 
Com mais dois botões você pode fazer esses LEDs apagarem. 


Basta clicar no botão para que um número seja gravado em um 
arquivo. Dependendo desse valor o seu programa no NodeMCU 
atuará para acender ou apagar o LED. 


O que acha? Dá para controlar qualquer coisa a distância e a partir 
de um clique! 


Na próxima experiência... 


... Vamos aprimorar ainda mais nossos conhecimentos sobre 
NodeMCU e em vez de ler uma página remota vamos transformá-lo 
em um servidor Web! A página a ser acessada será hospedada em 
seu NodeMCU. 


CAPÍTULO 14 
Experiência nº 10 - Mostrando valores de um 
sensor em uma página Web 


Com essa experiência, vamos ler a saída de um sensor e mostrar os 
valores em uma página Web. O sensor, no caso, será um 
potenciômetro ligado ao pino analógico no do NodeMCU. Mas com o 
que aprenderá aqui, você poderá usar qualquer outro sensor cuja 
saída seja um valor analógico ou até mesmo digital, a lógica será a 
mesma e talvez o código um pouco diferente. 


Imagine, por exemplo, usar um sensor de luminosidade (LDR) em 
vez do potenciômetro! No final dessa experiência você será 
desafiado a fazer isso. 


Para agora, teremos uma montagem e precisaremos de 
componentes externos, mas nada que já não tenha sido relacionado 
no início do livro. Vamos lá! 


O que é necessário: 


e 1 x NodeMCU 

e 1 x Cabo USB 

e 1 x Prot-o-board 

e 1 x Potenciômetro 
e 3x Cabinhos 


Esquema de montagem: 


Coloque o NodeMCU na prot-o-board e em seguida encontre um 
bom lugar para o potenciômetro, mais ou menos no meio da placa 
de ensaios. Lembre-se da ligação interna das trilhas de furos. 





Figura 14.1: NodeMCU e potenciômetro no prot-o-board 


Agora, usando cabinhos, ligue o terminal de uma das extremidades 
do potenciômetro ao pino 3v3 do NodeMCU, e o outro terminal, da 
outra extremidade, a um pino cnp do NodeMCU. Não há lado certo; 
dependendo da ligação, a única coisa que vai variar é em que lado o 
potenciômetro vai marcar o zero. 
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Figura 14.2: Os terminais das extremidades do potenciômetro ligados a um pino 3V3 e a 
um pino GND 


Para terminar essa montagem, usando o terceiro cabinho, ligue o 
terminal do meio do potenciômetro ao pino ao (ADCO — Analogic 
Digital Converter 0) do NodeMCU. 





Figura 14.3: O terminal do meio do potenciômetro no pino AO do NodeMCU 


Pronto, tudo montado, vamos programar! 
Programação: 


tinclude <ESP8266WiFi.h> 
tinclude <WiFiClient.h> 
tinclude <ESP8266WebServer.h> 


ESP8266WebServer servidor(80); 


int sensor = 0; 

int potenciometro = AQ; 

String pagina = ""; 

int tentativas = 50; 

char ssid[] = “iPhone de Fernando Bryan"; 
char senha[] = "biycoj7s5s9cs"; 


void setup(void)( 
pinMode(potenciometro, INPUT); 


Serial.begin(9600); 
WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 
} 
} 
Serial.println(); 
Serial.print("Conectado em "3; 
Serial.println(ssid); 
Serial.print ("Meu endereço IP = "3; 
Serial.printin(WiFi.localIP()); 


servidor.on("/", TIO( 
pagina = "<html>" 
"<head>" 
"<title>Dados potenciômetro</title>" 
"</head>" 
"<body>" 
"<h1>0 potenciômetro do NodeMCU esta em:</h1>" 
"<p><b>" + String(sensor) + "</b></p>" 
"</body>" 
"</html>"; 
servidor.send(200, "text/html", pagina); 
}); 
servidor .begin(); 
Serial.println("Servidor WEB iniciado!"); 


} 


void loop(void){ 
sensor = analogRead(potenciometro); 
servidor .handleClient(); 


} 


O que foi feito: 


O esquema de programação para conexão e resposta às 
requisições de página são os mesmos da experiência anterior. Só 
mudamos a variável que gera a página Web de lugar, do início do 
código para dentro da função de resposta à página principal ( / ). 


Com isso, a cada vez que for feita uma requisição, a variável pagina 
será atualizada com o valor capturado na variável sensor . Isso 
acontece na linha <p><b>" + String(sensor) + "</b></p>. 


Na função 1oo0p() , além da linha servidor.handleclient() , para que O 
servidor Web do NodeMCU capture as requisições que receber, 
temos a linha sensor = analogRead(potenciometro) que lê o valor do 
sensor do pino analógico no para a variável sensor. Essa variável 
servirá para atualizar a página Web a ser mostrada. 


Simples assim! 
Resultado esperado: 


Compile e envie seu programa para o NodeMCU. 


Abra o Monitor Serial para ver em qual IP está o NodeMCU: 








Conectado em iPhone de Fernando Bryan 


Meu endereço IP = 172.20.10.5 
Servidor WEB iniciado! 
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Figura 14.4: A rede em que o NodeMCU está conectado e o endereço IP que ele recebeu 


Agora acesse no seu navegador de internet, do celular ou do 
computador, o endereço do NodeMCU e você verá a seguinte 


página: 


17/2.20.10.5 


O potenciometro do NodeMCU esta em: 


316 


Figura 14.5: A página web do NodeMCU com o valor atual (316) do potenciômetro 


Mova o cursor do potenciômetro e atualize a página, você deverá 
ver o valor mudado. 


17/2.20.10.5 


O potenciometro do NodeMCU esta em: 


1024 


Figura 14.6: A página web do NodeMCU com o valor atual do potenciômetro, no caso o 
valor máximo (1024) 


Desafio: 


Já cantei a bola do desafio na introdução dessa experiência: troque 
o potenciômetro por um sensor, como o sensor de luminosidade 
(LDR) ou um sensor de temperatura. 


Se você entender e conhecer bem de programação Web, você 
também pode usar AJAX e JavaScript para atualizar o valor sem ter 
que atualizar a página. 


Na próxima experiência... 


... vamos transformar o NodeMCU em um ponto de acesso (Access 
Point), com isso você poderá conectar-se a ele assim como faz em 
sua rede WiFi em casa. 


Há muita coisa interessante pela frente, avancemos! 


CAPÍTULO 15 
Experiência nº 11 - NodeMCU funcionando como 
um ponto de acesso 


Nesta experiência, em vez de conectarmos o NodeMCU a uma rede 
sem fio qualquer, vamos abri-lo para que seja possível conectarmos 
nele. O NodeMCU será um ponto de acesso ao qual se poderá 
conectar qualquer equipamento capaz de conectar-se a uma rede 
sem fio. 


O NodeMCU funcionará como um AP (Access Point), ou seja, 
quando um cliente WiFi, que poderá ser um computador, um celular, 
tablet ou até mesmo outro NodeMCU, conectar-se a ele, será 
fornecido um endereço IP e, com isso, acesso à rede. 


Esta experiência consiste em permitir que você faça uma busca por 
redes sem fio, em seu computador ou celular, e encontre uma cujo 
nome você atribuiu via programação no seu NodeMCU, podendo ser 
protegida por senha ou não. Ao conectar-se a ela, ganhará acesso à 
página Web contida no NodeMCU, que pode controlar qualquer 
coisa, dar acesso a outras páginas ou funcionalidades, do mesmo 
jeito que fizemos até agora nas experiências anteriores. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 
Não há montagem necessária. 
Programação: 


tinclude <ESP8266WiFi.h> 
tinclude <ESP8266WebServer.h> 


ESP8266WebServer servidor(80); 


IPAddress local IP(192, 168, ©, 1); 
IPAddress gateway(192, 168, O, 1); 
IPAddress subnet (255, 255, 255, 0); 


char ssid[] = "meu AP sem senha"; 


int clientes = 0; 


String pagina = 


void setup() 
{ 
Serial.begin(9600); 
if(WiFi.softAPConfig(local IP, gateway, subnet)) { 
Serial.printin("OK"); 
+ else { 
Serial.printin("Falhou! "3; 
while(true); 
} 
if(WiFi.softAP(ssid)) { 
Serial.println("O0K"); 
} else { 
Serial.println("Falhou!"); 
while(true); 
} 
Serial.print("Endereço IP do Access Point = "); 
Serial.println(WiFi.softAPIP()); 
servidor.on("/", TIO( 
pagina = "<html>" 
"<head>" 
"<title>NodeMCU como Ponto de Acesso</title>" 
"</head>" 
"<body>" 
"<hi>Numero de clientes conectados nesse momento:</h1>" 
"<p><center><hi><b>" + String(clientes) + "</b></h1> 
</center></p>" 
"</body>" 
"</html>"; 
servidor.send(200, "text/html", pagina); 


D; 


servidor.begin(); 


} 


void loop() { 
if (WiFi.softAPgetStationNum() != clientes) { 
clientes = WiFi.softAPgetStationNum(); 
Serial.println("Numero de clientes = " + String(clientes)); 


} 


servidor .handleClient(); 


} 
O que foi feito: 


Você já deve estar familiarizado com a maioria dos comandos 
usados, mas claro, há sempre coisas novas para ver e aprender. 


De início, criamos um objeto para o servidor Web, que responderá 
na porta so, com a linha ESP8266WebServer servidor(80) . 


Em seguida, declaramos três variáveis do tipo IPAddress para que 
recebam endereços IP: 1ocal IP ( 192.168.0.1 ), que será o endereço 
do NodeMCU como Access Point (ponto de acesso) - IPAddress 

local IP(192, 168, O, 1); gateway ( 192.168.0.1 ), que será o endereço 
de gateway da rede criada - IPAddress gateway(192, 168, ©, 1); @ subnet 
( 255.255.255.0 ), que será a máscara de sub-rede para o NodeMCU e 
para todos os clientes que se conectarão a ele - IPAddress subnet (255, 
255, 255, 0). 


Para continuar, precisamos dar um nome à nossa rede sem fio. 
Fazemos isso por meio de uma variável que será um vetor do tipo 
char (caracteres) chamada ssia . Alterando a linha char ssid[] = 
"meu AP sem senha”, você altera o nome da rede. 


Ainda especificamente para essa experiência, declaramos uma 
variável do tipo inteiro ( int ) chamada clientes , que será inicializada 
com zero . Essa variável registrará a quantidade de clientes 
conectados ao NodeMCU. 


Já na função setup() , temos o seguinte trecho: 


if(wiFi.softAPConfig(local IP, gateway, subnet)) { 
Serial.printin("OK"); 
} else { 
Serial.println("Falhou!"); 
while(true); 


} 


Nesse trecho, configuramos o NodeMCU para ser um Access Point 
com o comando wiFi.softAPConfig(local_IP, gateway, subnet) , NO qual O 
endereço IP, o endereço do gateway e a máscara de sub-rede são 
informados de acordo com as variáveis declaradas para isso e já 
detalhado. 


Toda essa operação de iniciar o funcionamento do NodeMCU como 
um Access Point está dentro de uma estrutura if para verificarmos 
se a configuração aconteceu com sucesso. Caso o comando retorne 
true (verdadeiro), mostramos a mensagem ok no Monitor Serial; caso 
contrário, enviamos a mensagem Falhou! e interrompemos o 
programa permanentemente. 


Com a configuração registrada, precisamos iniciar o Access Point. 
Fazemos isso com o seguinte trecho: 


if(WiFi.softAP(ssid)) { 
Serial.printin("OK"); 

+ else { 
Serial.printin("Falhou! "3; 
while(true); 


} 


O comando wiFi.softap(ssid) inicia o Access Point e começa a 
divulgar o nome da rede sem fio que está armazenado na variável 
ssid , que no caso dessa experiência será meu_AP_sem_senha . 


Enviamos para o Monitor Serial o endereço IP do NodeMCU usando 
o comando wiFi.softaPIP() para nos certificarmos de que ele foi 
atribuído corretamente. 
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Figura 15.1: O endereço IP do NodeMCU no Monitor Serial 


Com o seguinte trecho, criamos a página Web que será respondida 
quando o NodeMCU for acessado: 


servidor.on("/", [IOL 
pagina = "<html>" 
"<head>" 
"<title>NodeMCU como Ponto de Acesso</title>" 
"</head>" 
"<body>" 
"<hi>Numero de clientes conectados nesse momento:</h1>" 
"<p><center><h1i><b>" + String(clientes) + "</b></h1> 
</center></p>" 
"</body>" 
"</html>"; 
servidor.send(200, "text/html", pagina); 
}); 


servidor .begin(); 


Ela mostrará a quantidade de clientes conectados naquele 
momento, com a linha <p><center><hi><b>" + String(clientes) + "</b> 
</h1></center></p> . Como a variável clientes é do tipo inteiro, ela 
precisa ser convertida em caracteres pela função string . 


Na função 1oo0p() , temos poucas linhas de código: 


void loop() { 
if (WiFi.softAPgetStationNum() != clientes) ( 
clientes = WiFi.softAPgetStationNum(); 
Serial.println("Numero de clientes = " + String(clientes)); 


} 


servidor .handleClient(); 


} 


No if usamos o comando wiFi.softaPgetstationNum() para obter a 
quantidade de clientes conectados e comparamos seu resultado 
com o que está armazenado na variável clientes . Caso seja 
diferente, ou seja, tenha mais ou menos clientes agora do que 
anteriormente, usamos a linha clientes = wiFi.softAPgetStationNum() 
para atualizar na variável clientes a quantidade de conexões atuais, 
e a linha Serial.printin("Numero de clientes = " + String(clientes)) para 
mostrar o número também no Monitor Serial. 
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Figura 15.2: A quantidade de clientes conectados mostrada no Monitor Serial 


Com servidor .handleclient() , processamos as requisições de acesso 
dos clientes, conforme já vimos em experiências anteriores. 


Resultado esperado: 


Depois de compilar e carregar o programa no NodeMCU, use seu 
computador ou celular para procurar por redes sem fio. Você deverá 
encontrar uma chamada meu aP sem senha. 


< Ajustes Wi-Fi 


Wi-Fi 





ESCOLHA UMA REDE... `°% 


meu AP sem senha F (1) 
NALU a = (1) 
Simneti a F © 


Outra... 


Solicitar Conexão 


es ~ ~ 


Figura 15.3: Busca por redes sem fio com a rede que acabamos de criar encontrada 


Conecte-se a ela. 


Acesse o endereço do NodeMCU para ver a página com o número 
de clientes conectados. 


192.168.0.1 


Numero de clientes conectados nesse momento: 


2 


Figura 15.4: Página fornecida pelo NodeMCU com o número de clientes conectados no 
momento 


Mas você deve estar achando estranho que a rede não possui 
nenhuma proteção com senha ou criptografia. Desse jeito, qualquer 
um poderia conectar-se ao NodeMCU, acessar a página dele e, de 
repente, alterar configurações ou obter dados do equipamento. 
Saiba que mudar isso é muito simples! 


O método softar , da linha wiri.softap(ssid) , aceita um segundo 
parâmetro, que é a senha do WiFi. Vamos ver um código completo, 
com essa alteração. 


Programação: 


tinclude <ESP8266WiFi.h> 
tinclude <ESP8266WebServer.h> 


ESP8266WebServer servidor(80); 


IPAddress local IP(192, 168, ©, 1); 
IPAddress gateway(192, 168, ©, 1); 
IPAddress subnet (255, 255, 255, 0); 


char ssid[] = "meu AP sem senha"; 
char senha[] = "12345678"; 


int clientes = 0; 
String pagina = ""; 


void setup() 
{ 
Serial.begin(9600); 
if(WiFi.softAPConfig(local IP, gateway, subnet)) { 
Serial.printIn("OK"); 
+ else { 
Serial.printin("Falhou! "3; 
while(true); 


} 
if(WiFi.softAP(ssid,senha)) { 


Serial.printIn("OK"); 
+ else { 
Serial.printin("Falhou! "3; 
while(true); 
} 
Serial.print("Endereço IP do Access Point = "); 
Serial.println(WiFi.softAPIP()); 
servidor.on("/", TIO( 
pagina = "<html>" 
"<head>" 
"<title>NodeMCU como Ponto de Acesso</title>" 
"</head>" 
"<body>" 
"<hi>Numero de clientes conectados nesse momento:</h1>" 
"<p><center><h1><b>" + String(clientes) + "</b></h1> 
</center></p>" 
"</body>" 
"</html>"; 
servidor.send(200, "text/html", pagina); 
}); 
servidor .begin(); 


} 


void loop() { 
if (WiFi.softAPgetStationNum() != clientes) { 
clientes = WiFi.softAPgetStationNum(); 
Serial.printin("Numero de clientes = " 


} 


servidor .handleClient(); 


+ String(clientes)); 


} 
O que foi feito: 


Criamos a variável senha , que é um vetor do tipo char com char 
senha[] = "12345678" . Note que a senha precisa obrigatoriamente ter 
no mínimo 8 caracteres. 


E também alteramos a linha if(wiFi.softaP(ssid)) { , que passou a 
Ser if(WiFi.softaP(ssid,senha)) 4 . Dessa forma, além do ssid 


definimos qual a senha da rede, que será o conteúdo da variável 
senha ( 12345678 ). 


Faça a busca de redes sem seu computador ou celular e você verá 
a indicação de rede com senha, como na imagem a seguir: 


< Ajustes Wi-Fi 
LopesHouse a + (1) 
meu AP sem senha a = (1) 
Moto G Play 6780 as (1) 


Figura 15.5: Na hora da busca por redes, o ícone do cadeado indica que a rede tem senha 


Quando tentar conectar, será solicitada a senha, como na imagem a 
seguir: 


Digite a senha de “meu AP sem senha” 


Cancelar Digite a Senha 


Senha 


Para acessar esta rede Wi-Fi, você também pode 
aproximar o iPhone de um iPhone, iPad ou Mac 
conectado a ela e que tenha você como um contato. 
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Figura 15.6: Solicitação de senha para conexão 
Desafio: 


Esse pode ser um bom jeito de conectar-se ao NodeMCU em locais 
onde uma rede sem fio não esteja disponível. Em locais afastados 
de quaisquer infraestruturas de redes, no caso da necessidade de 
interação com o equipamento, essa me parece a melhor saída. 


Sendo assim, que tal usar a interação de controle de LED que 
fizemos anteriormente e desenvolvê-la assim, com conexão ao 
NodeMCU através do funcionamento dele como ponto de acesso? 


Na próxima experiência... 


... Você conhecerá o sistema de arquivos que o NodeMCU tem 
embutido. Com ele, será possível gravar dados de forma 
persistente. Vamos em frente! 


CAPÍTULO 16 
Experiência nº 12 - O sistema de arquivos interno 
do NodeMCU 


Em algum momento, você vai se deparar com a necessidade de 
manter dados permanentemente no NodeMCU. Seja alguma 
configuração que não pode ser perdida a cada vez que o 
equipamento desligar ou algum dado variável que deve ser mantido 
continuamente para histórico, como em um data-logger. Enfim, é 
melhor estar preparado! 


No Arduino, usaríamos a memória EEPRoM , que também existe no 
NodeMCU. Ela facilita bastante o porte de seus projetos do Arduino. 
Mas agora temos um sistema de arquivo próprio no NodeMCU, 
montado na memória flash. Esse sistema de arquivos chama-se 
EsPp8266FS (ES P8266 File System) ou SPIFFS (Serial Protocol 
Interface Flash File System). O tamanho desse sistema de arquivos 
pode variar de acordo com a versão da placa NodeMCU: 


Tamanho da Tamanho do sistema 
Placa memória flash de arquivos 
embarcada disponível 
Generic module 512 KB 64 KB 
64 KB, 128 KB, 256 
Generic module 1 MB KB, 512 KB 
Generic module 2 MB 1 MB 
Generic module 4 MB 3 MB 
Adafruit 
HUZZAH 4 MB 1 MB, 3 MB 


NodeMCU 0.9 4 MB 1 MB, 3 MB 


Tamanho da Tamanho do sistema 


Placa memória flash de arquivos 
embarcada disponível 
NodeMCU 1.0 4 MB 1 MB, 3 MB 
Olimex MOD- 
WIFI-ESP8266(- 2 MB 1MB 
DEV) 
SparkFun Thing 512 KB 64 KB 
SweetPea ESP- 4 MB 1 MB, 3 MB 
210 
VETO DIS. AND 1 MB, 3 MB 
mini 
Fonte: 


http://esp8266.github.io/Arduino/versions/2.0.0/doc/filesystem.html 


O modelo da maioria dos NodeMCU chineses, que é o caso do que 
estou usando, é o NodeMCU 0.9 ou NodeMCU 1.0, o que nos dá 
pelo menos 1 MB de espaço para o sistema de arquivos. 


Nesse sistema de arquivos, é possível criar, manipular e apagar 
qualquer tipo de arquivo, desde que o seu tamanho seja compatível 
com o espaço disponível. E há pelo menos dois jeitos de lidar com 
esses arquivos: criando, manipulando e apagando internamente em 
nosso programa; ou carregando arquivos diretamente da IDE 
Arduino e manipulando-os em nosso programa. 


Vamos ver tudo isso na prática! 
O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 
Não há montagem necessária. 
Programação: 

Hinclude <FS.h> 

String arquivo = "/numero.txt”; 


void setup() { 
Serial.begin(9600); 
delay(500); 
boolean ok = SPIFFS.begin(); 
if (ok) { 
boolean existe = SPIFFS.exists(arquivo); 


if (existe) { 
File arq = SPIFFS.open(arquivo, "r"); 
if (larg) { 
Serial.println("Deu alguma coisa errada com o arquivo! 
(Leitura)"); 
+ else { 
Serial.printin("O arquivo existe!"); 
Serial.printin("Tamanho do arquivo = " + String(arq.size()) + 
bytes"); 
String dados = arqg.readStringUntil('An'); 
Serial.printin("Valor atual = " + dados); 
arqg.close(); 
File arq = SPIFFS.open(arquivo, "w+"); 
if (larg) { 
Serial.println("Deu alguma coisa errada com o arquivo! 
(Atualização)"); 
} else { 
arq.println(String(dados.toInt()+1)); 
arq.close(); 
} 


} 
} else { 
Serial.println("O arquivo nao existe!"); 


Serial.printin("Gravando zero!"); 
File arq = SPIFFS.open(arquivo, "w"); 
if (larg) { 
Serial.println("Deu alguma coisa errada com o arquivo! 
(Gravação)"); 
+ else { 
arq.printin("0"); 
arq.close(); 
} 
} 
} 
} 


void loop() {} 
O que foi feito: 


A primeira coisa é importar a biblioteca Fs.h com a linha #include 
<FS.h> . Ela nos fornecerá todos os comandos e funções necessárias 
para trabalharmos com arquivos. 


Já na segunda linha, criamos uma variável do tipo string chamada 
arquivo , que conterá o nome do arquivo que vamos manipular. 
Fazemos isso com a linha string arquivo = "/numero.txt" . Isso torna 
mais fácil uma mudança no nome do arquivo caso seja necessário 
ao projeto. 


Com a linha boolean ok = SPIFFS.begin() , Criamos a variável lógica 
chamada ok para receber o resultado de spIFFS.begin() , que inicia o 
sistema de arquivos do NodeMCU. Caso consiga iniciar o sistema 
de arquivos com sucesso, retornará true (verdadeiro); caso 
contrário, retornará false (falso). 


Testando a variável ox com um if, fica fácil continuar o programa em 
caso de sucesso, ou emitir erro e parar tudo, caso contrário. E o que 
fazemos com a estrutura de seleção if (ax). 


Usamos a linha boolean existe = SPIFFS.exists(arquivo) para verificar 
se o arquivo existe. A variável existe , que é do tipo lógico, receberá 


true (verdadeiro) caso sPIFFS.exists(arquivo) retorne true (verdadeiro), 
indicando a existência do arquivo. Caso o arquivo não exista 
SPIFFS.exists(arquivo) , retornará false (falso). 


Na sequência, usamos um if(existe) para definir o que acontecerá 
se o arquivo existir ou não. No nosso caso, caso o arquivo exista, 
será mostrado seu tamanho no Monitor Serial e, em seguida, seu 
conteúdo atual, que será um número. O número existente no 
arquivo será somado a 1, e o arquivo será regravado com o novo 
valor. Fazemos isso com o trecho: 


File arq = SPIFFS.open(arquivo, "r"); 
if (larg) { 

Serial.println("Deu alguma coisa errada com o arquivo! (Leitura)"); 
+ else { 

Serial.println("O arquivo existe!"); 

Serial.printin("Tamanho do arquivo = 


+ String(arq.size()) + 


bytes"); 
String dados = arq.readStringUntil('An'); 
Serial.println("Valor atual = " + dados); 


arg.close(); 
File arq = SPIFFS.open(arquivo, “w+"); 
if (larg) { 
Serial.println("Deu alguma coisa errada com o arquivo! 
(Atualização)"); 
} else { 
arq.println(String(dados.toInt()+1)); 
arq.close(); 


} 
} 


A primeira ação para realizar a tarefa descrita anteriormente é abrir 
o arquivo. O retorno de spIFFS.open(arquivo, "r") será um descritor 
com um ponteiro para o arquivo, igual ao que acontece com a 
linguagem C tradicional. Para receber isso, precisamos da variável 
arq , que é do tipo FILE. 


Caso a linha File arq = SPIFFS.open(arquivo, "r") retorne false (falso) O 
programa foi impossibilitado de abrir o arquivo; já se puder, ele 


retornará true (verdadeiro). 


É sempre necessário verificar se cada ação ocorreu normalmente 
ou houve problemas, para evitar perda de dados, ou que o usuário 
acredite que está tudo bem quando não está. 


SPIFFS.open(arquivo, "r") recebe dois parâmetros, sendo o primeiro 
uma string com o nome e caminho para o arquivo, e o segundo, 
uma string , que pode ser: 


Modo 
de Descrição 

abertura 

E gravação - se existir, é apagado e um novo arquivo 
criado. 

r leitura - o arquivo deve existir. 

5 append - abre o arquivo para gravação ao final. O 
arquivo deve existir. 

T gravação - abre o arquivo para atualização 
(gravar/ler). Se existir, é criado um novo. 

E leitura - abre o arquivo para atualização (gravar/ler). 
Arquivo deve existir. 
adição - abre o arquivo para atualização (gravar/ler), 

a+ dados são adicionados ao final. Arquivo é criado se 


não existir. 


Caso o arquivo seja aberto, seguiremos com o plano de ler seu 
conteúdo e somar 1 ao número encontrado: 


Serial.printIn("O arquivo existe!"); 
Serial.println("Tamanho do arquivo = " + String(arq.size()) + " bytes"); 
String dados = arq.readStringUntil('Nn'); 


Serial.printin("Valor atual = " + dados); 
arq.close(); 


File arq = SPIFFS.open(arquivo, "w+"); 
if (larg) { 

Serial.printin("Deu alguma coisa errada com o arquivo! (Atualização)"); 
} else { 

arq.println(String(dados.toInt()+1)); 

arq.close(); 


} 


O método size() retorna um valor inteiro correspondente ao tamanho 
em bytes do arquivo aberto. Com a linha Serial.println("Tamanho do 
arquivo = " + String(arq.size()) + " bytes") emitimos uma mensagem 
no Monitor Serial com essa informação. Como arq. size() retorna um 
número, é necessário usar a função string para convertê-lo para 
texto. 


Com a linha string dados = arq.readsStringuntil('n') lemos a primeira 
linha do arquivo para a variável dados , que é do tipo string. 
Podemos usar arq.readString() € arq.readStringUntil('in'), que foi O 
que efetivamente usamos. O primeiro método nos retornará o 
arquivo inteiro em uma string e o segundo retornará a string 
resultante até que o caractere \n ( Enter — New Line ) seja encontrado. 


Usamos serial.printIn("Valor atual = " + dados) para mostrar o que foi 
lido no Monitor Serial e arqg.close() para fechar o arquivo. 


Com todos esses passos, abrimos o arquivo, lemos seu conteúdo e 
o mostramos no Monitor Serial. 


Agora vamos abri-lo novamente, mas no modo de gravação com 
File arq = SPIFFS.open(arquivo, "w+") . Com isso, poderemos gravar o 
novo conteúdo, ou seja, o valor lido anteriormente adicionado de 1 
Com arqg.printin(String(dados.toInt()+1)); e fechar o arquivo com 


arg.close() . 


Toda vez que você reiniciar o NodeMCU, desligando-o e ligando 
novamente ou pressionando o botão de rEsET , você verá no Monitor 
Serial que o número do conteúdo atual do arquivo aumentar de um 
em um. 


Mas se for a primeira vez em que você está executando o programa, 
o arquivo não existirá, então o seguinte trecho será executado: 


Serial.printin("O arquivo nao existe!"); 
Serial.printin("Gravando zero!"3; 
File arq = SPIFFS.open(arquivo, "w"); 
if (larg) { 
Serial.println("Deu alguma coisa errada com o arquivo! (Gravação)"); 
+ else { 
arq.printin("0"); 
arg.close(); 


} 


Usamos File arq = SPIFFS.open(arquivo, "w") para abrir o arquivo para 
gravação, arq.println("0") para gravar um número zero nele e 
arg.close() para fechá-lo. 


A função 1oop() está vazia e não executará nada nessa experiência. 
Resultado esperado: 


Compile e carregue o programa no NodeMCU já com o Monitor 
Serial aberto. Você verá a mensagem de que o arquivo não existe e 
foi gravado o valor zero nele, como na imagem a seguir: 





COM5 — o x 








Enviar 
O arquivo nao existe! 
Gravando zero! 
[4] Auto-rolagem Nenhum final-de-linha v 9600 velocidade v Deleta a saida 





Figura 16.1: Iniciando o programa pela primeira vez 


Reinicie o NodeMCU algumas vezes, para isso você pode usar o 
botão RESET . Fazendo isso, você verá no Monitor Serial que o 
número do arquivo vai aumentar de um em um. Como na imagem a 
seguir: 





COM5 — o x 





| Enviar 
O arquivo nao existe! 

Gravando zero! 

$S$%=bSSO arquivo existe! 

Tamanho do arquivo = 3 bytes 

Valor atual = 0 

DSDSs3Rso arquivo existe! 

Tamanho do arquivo = 3 bytes 

Valor atual = 1 

$S/SSO3RSO arquivo existe! 

Tamanho do arquivo = 3 bytes 

Valor atual = 2 

DSOSsbSSO arquivo existe! 

Tamanho do arquivo = 3 bytes 

Valor atual = 3 

DSOSsbSSO arquivo existe! 

Tamanho do arquivo = 3 bytes 

Valor atual = 4 

[4] Auto-rolagem Nenhum final-de-linha «» |9600 velocidade vV Deleta a saida 





Figura 16.2: A cada vez que o programa é reiniciado soma-se um ao conteúdo do arquivo 


Mas lembre-se de que eu mencionei anteriormente que há outro 
jeito de criar arquivos: carregá-los na IDE Arduino, junto com o 
programa. Dessa forma, podemos criar arquivos mais complexos 
em nosso computador e carregá-los para o NodeMCU para que 
sejam manipulados por nosso programa. 


Primeiro, antes de fazer um novo código, vamos mandar nosso 
arquivo para o NodeMCU. Para isso, precisaremos de uma nova 
ferramenta adicionada ao IDE Arduino através do plugin 
ESP8266FS. 


Encontre a última versão do plugin em 
https://github.com/esp8266/arduino-esp8266fs-plugin/releases/ e 
faça o download do arquivo .z1p dele. 


Descompacte esse arquivo dentro da pasta toos no local onde seu 
IDE Arduino está instalado. 





B v] E! = | tools 
Início Compartilhar Exibir 


a EE E do Recortar pi [i B] x =f 1 Th Novo item ~ M T Abrir ~ FH selecionar tudo 
w3 Copiar caminho 


t) Fácil acesso 7 Editar Selecionar nenhum 
Fixar no Copiar C 








Mover Copiar Excluir Renomear Nova Propriedades 
Acesso rápido [Z] Colar atalho parar parar há pasta = Histórico Ef Inverter seleção 
Area de Transferência Organizar Novo Abrir Selecionar 
e “4 B > Este Computador > Windows (C:) > Arquivos de Programas (x86) > Arduino > tools > vw 
v E Arduino S Nome E Data de modificaç... Tipo Tamanho 
[3 drivers E! ESP8266FS 17/11/2016 16:06 Pasta de arquivos 
E examples | Mangler 03 Pasta de arquivos 
B hardware E WiFi101 5 Pasta de arquivos 
T java E] howto 02/10/2017 10:37 Documento de Te... 6 KB 
[}] lib 
B libraries 
B reference 
du B tools 
» || ESP8266FS 
E tool 
O Mangler 
F wifi101 


B tools-builder 


Figura 16.3: Local onde o plugin deve ser descompactado 


Feche e abra novamente seu IDE Arduino, você deverá ter a opção 
ESP8266 Sketch Data Upload no menu Ferramentas. 





sketch | Arduino 1.8.5 — o x 





[ 


Arquivo Editar Sketch Ferramentas Ajuda 








Autoformatação Ctrl+T 
Arquivar Sketch 
sketch Corrigir codificação e recarregar 
void setup() { Monitor serial Ctrl+Shift+M |^ 
// pūt your SeT Plotter serial Ctrl+Shift+L 
} ESP8266 Sketch Data Upload 
void loop() | WiFi101 Firmware Updater 
// put your main pjaca: "NodeMCU 0.9 (ESP-12 Module)" > 
} Flash Size: "4M (1M SPIFFS)" > 
Debug port: "Disabled" > 
Debug Level: "Nenhum" > 
lwIP Variant: "v2 Lower Memory" > 
VTables: "Flash" > 
CPU Frequency: "80 MHz" > 
Upload Speed: "115200" > 
Erase Flash: "Only Sketch" > 
Porta: "COM5" > 


Obter informações da Placa 


Programador: "AVRISP mkl|" 


Gravar Bootloader 


MHz, Flash, 4M (1M SPIFFS), v2 Lower Memory, Disabled, None, Only Sketch, 115200 em COMS 





Figura 16.4: A opção ESP8266 Sketch Data Upload no menu Ferramentas 


Agora vamos ao novo código: 


#include <FS.h> 
String arquivo = "/texto.txt”; 


void setup() { 
Serial.begin(9600); 
delay(500); 
boolean ok = SPIFFS.begin(); 
if (ok) { 
boolean existe = SPIFFS.exists(arquivo); 
if (existe) { 
File arq = SPIFFS.open(arquivo, "r"); 
if (larg) { 
Serial.println("Deu alguma coisa errada com o arquivo! 
(Leitura)"); 
+ else { 
Serial.println("O arquivo existe!"); 
Serial.println("Tamanho do arquivo = " + String(arq.size()) + " 
bytes"); 
String dados = arqg.readString(); 
Serial.printin("Texto = " + dados); 
arq.close(); 
} 
} 
} 
} 


void loop() {} 


Fora o carregamento do arquivo, o funcionamento do código será o 
mesmo do exemplo anterior. 


Salve o programa em seu computador e depois vá até ele e crie 
uma pasta chamada data , como na figura a seguir: 


| IM] = | 18, Lendo arquivo carregado junto com o programa es 


Início Compartilhar Exibir 
E % Recorta r Th Novo item 7 A At + Selecionar tudo 
of i v| 
w Copi = ] - Editar 


ami 7 | Fácil acesso 7 Selecionar nenhum 





Fixar no opiar Cola Ê Mover Copia Excluir Renomea Nova Propriedades j a s 
Acesso rápido [2] Colar atalho Sina NES E pasta 5 l@ Histórico F inverter seleção 
Área de Transferência Organizar Novo Abrir Selecionar 
— “4 «< PENDRIVE-32 (E:) > Livros > NodeMCU > 18, Lendo arquivo carregado junto com o programa > vo Pesquisar 18, Len 
08. Conectando a uma rede e verificando conexao A Nome Data de modificaç... Tipo 
09. Conectando a um servidor e lendo uma pagina we deita 10/11/2017 16:32 Pasta de arquivos 
10. Lendo uma pagina e verificando o conteudo fee} 18._Lendo_arquivo_carregado_junto_com_o_programa 11/06/2018 16:09 Arduino file 


11. Servidor web 

12. Servidor web controlando um LED 

13. Mostrando valores de sensores em uma pagina wel 
14. Pingando endereco remoto 

15. Como um access point sem senha 

16. Como um access point com senha 

17.0 sistema de arquivos SPIFFS 

18. Lendo arquivo carregado junto com o programa 


Figura 16.5: A pasta data criada no mesmo local onde o código-fonte foi salvo 


Todos os arquivos que estiverem dentro dessa pasta serão enviados 
para o NodeMCU e armazenados na memória flash, compondo o 
sistema de arquivos. 


Para exemplificar, dentro da pasta data crie um arquivo texto 
chamado texto.txt e, como conteúdo, fique à vontade para escrever 
livremente algumas linhas. O meu ficou assim: 


É] texto - Bloco de notas — O x 


Arquivo Editar Formatar Exibir Ajuda 
pi! 


Fui carregado pela IDE Arduino na memoria flash do NodeMCU! 





Figura 16.6: Exemplo de conteúdo do arquivo texto 


Resultado esperado: 


Criamos um arquivo texto e o colocamos dentro da pasta data , que 
deve existir no mesmo local onde o projeto estiver salvo. Todos os 
arquivos que existirem nessa pasta específica serão enviados ao 
NodeMCU. 


Para realizar o envio, vá até o menu Ferramentas da sua IDE Arduino 
e acione a opção EsP8266 Sketch Data Upload : 


18. Lendo arquivo carregado junto com o programa | Arduino 1.8.5 — O x 


Arquivo Editar Sketch Ferramentas Ajuda 





Autoformatação Ctrl+T 
Arquivar Sketch 
va Pando amu. Corrigir codificação e recarregar 
Janeina Eak Monitor serial Ctrl+Shift+M S 
String arquivo = "| Plotter serial Ctrl+Shift+L 
void setup() | ESP8266 Sketch Data Upload 
Serial.begin (960 WiFi101 Firmware Updater 
delay (500); 
boolean ok = SPI Placa: "NodeMCU 0.9 (ESP-12 Module)" > 
if (ok) { Flash Size: "4M (1M SPIFFS)" > 
pd e. Debug port: "Disabled" > 
Serial.printin E E 
if (existe) ( Debug Level: "Nenhum > 
File arq = 5 lwIP Variant: "v2 Lower Memory" > 
a i VTables: "Flash" > 
Serial.pri A e itura)”); 
Jéis À CPU Frequency: "80 MHz > 
Serial.pri Upload Speed: "115200" > 
Serial.pri Erase Flash: "Only Sketch" >|) + " bytes"); 
String dad porta: "COMS" > 
Serial.pri 
arg.close( Obter informações da Placa y 


Programador: "AVRISP mkll” 


Gravar Bootloader 


No deMCU 0.9 (ESP-12 Module), 80 MHz, Flash, 4M (1M SPIFFS), v2 Lower Memory, Disabled, None, Only Sketch, 115200 em COMS 





Figura 16.7: A opção para enviar os arquivos da pasta data para o NodeMCU 


No console da IDE, você verá o andamento do upload dos dados e, 
quando concluído, terá algo semelhante à imagem a seguir: 


18. Lendo arquivo carregado junto com o programa | Arduino 1.8.5 = 0 x 


Arquivo Editar Sketch Ferramentas Ajuda 


18._Lendo_arquivo_carregado_junto_com_o_programa § 
include <FS.h> 





String arquivo = "/texto.txt"; 


void setup({) { 
Serial.begin(9600); 
delay (500); 
boolean ok = SPIFFS.begin(); 
if (ok) { 
if (existe) ( 
File arq = SPIFFS.open (arquivo, "r"); 


if (!arq) { 
Serial.println("Deu alguma coisa errada com o arquivo! (Leitura)"); 
} else { 


Serial.println("0 arquivo existe!”) 


Serial.println ("Tamanho do arquivo = " + String(arq.size()) + " bytes"); 
String dados = arq.readString(); 
Serial.println("Texto = " + dados); 


arq.close(); 





WodeMCU 0.9 (ESP-12 Module), 80 MHz, Flash, 4M (1M SPIFFS Lower Memory, Disabled, None, Only Sketch, 115200 em C( 


Figura 16.8: Transferência dos arquivos da pasta data para o NodeMCU concluída 


Agora carregue o programa no NodeMCU normalmente e, com o 
Monitor Serial aberto, você verá o resultado idêntico ao da próxima 
imagem: 











COM5 — o x 








Enviar 
O arquivo existe! A 
Tamanho do arquivo = 64 bytes 
Texto = OI! 
Fui carregado pela IDE Arduino na memoria flash do NodeMCU! 
v 
[4] Auto-rolagem Nenhum final-de-linha v 9600 velocidade v Deleta a saida 





Figura 16.9: O arquivo lido 


Desafio: 


Crie um programa que leia o valor de um potenciômetro conectado 
ao NodeMCU e grave a leitura em um arquivo no SPIFFS. Quando o 
NodeMCU for desligado e religado, o último valor lido deverá ser 
mostrado no Monitor Serial. 


Na próxima experiência... 


... Vamos aprender como verificar se um equipamento remoto, como 
outro NodeMCU ou mesmo um servidor está disponível na rede 
para enviar ou receber dados. 


Siga em frente, há mais para aprender! 


CAPÍTULO 17 
Experiência nº 13 - Verificando um endereço 
remoto (ping) 


Quando estamos tratando de conexões remotas, não há outro meio 
de verificar se o outro equipamento ou computador está ou não 
ligado e funcional, senão fazê-lo pessoalmente ou usar o protocolo 
ICMP tipo 8, o famoso ping. 


O comando ping no Windows e também no Linux dispara um pacote 
echo request (requisição de eco) para o endereço remoto, que, 
tendo a pilha TCP/IP funcional, vai recebê-lo, copiar seu conteúdo e 
enviá-lo de volta ao remetente (eco). 


O Windows, em qualquer versão, tem esse comando implementado. 
Basta ir ao prompt de comando ( cma ) e digitar ping seguido do 
endereço IP ou URL que você deseja verificar se está responsível, 
veja um exemplo: 














EM Prompt de Comando = x 








Figura 17.1: O comando ping www.google.com.br no Windows e seus resultados 





O comando ping pode ser usado às vezes para descobrir o IP de um 
servidor que hospeda algum domínio. Por exemplo, na imagem 
anterior você tem o resultado do ping para www.google.com.br . À 
primeira resposta é Disparando www.google.com.br [172.217.28.67] com 32 
bytes de dados: |]. 


O tamanho de 32 bytes não nos vem ao caso por ora, mas note que 
ele resolve o endereço www.google. com.br € Nos revela o endereço 
172.217.28.67 , que é do servidor que respondeu a essa requisição. 
Você pode obter endereços diferentes dependendo do horário e do 
local em que estiver porque o Google, claro, usa muitos servidores 
em muitos locais do mundo. 


Também podemos usar o ping contra um endereço IP. Vamos tentar 
o endereço do Google que obtivemos no exemplo anterior, veja: 














EM Prompt de Comando >: x 








Figura 17.2: O comando ping 172.217.28.67 no Windows e seus resultados 


O resultado é o mesmo, o computador remoto também e a 
rede/intemet não sofreram qualquer variação, portanto temos 
resultados iguais. 





Para qualquer coisa desenvolvida para loT pode ser interessante 
usar esse conceito para verificar se equipamentos parceiros ou 
servidores remotos estão ativos e funcionais antes de realizar 
alguma transmissão de dados. Lembre-se da 5º Experiência, sobre 
ler uma página Web. Poderíamos ter verificado se o servidor 
responderia a um teste com ping antes de tentar ler a página. Caso 
não respondesse, nem tentaríamos a conexão e a leitura. Já 
informaríamos de alguma forma (LED vermelho, display, mensagem 
etc.) que não seria possível realizar a tarefa. 


Como o ping também retorna o tempo de resposta, ou seja, o tempo 
que o pacote levou para ir até o destino, ser copiado e ser enviado 
de volta, é possível tomar várias ações baseadas nisso. Uma dessa 
ações poderá ser ajustar o tempo de time-out do seu programa 
dinamicamente, ou seja, você dispara um ping para um outro 
equipamento e sabendo que a resposta poderá demorar um tempo 
maior ou menor, ajudar o tempo de espera para não perder 
praticamente nenhuma possibilidade ou janela de transmissão de 
dados. 


Fazer esse tipo de controle é importante quando se espera 
respostas para uma determinada transmissão. Se você enviar dados 
e esperar uma resposta é preciso desenvolver meios para que seu 
programa não fique em modo de espera para sempre, aguardando 
algo que pode nunca chegar. Crie um time-out (tempo de espera) 
que, caso seja atingido, faz com que o programa realize alguma 
outra tarefa ou emita algum erro, assim como já fizemos para 
conectar em redes sem fio. 


O que é necessário: 


e 1 x NodeMCU 
e 1 x Cabo USB 


Esquema de montagem: 


Não há montagem necessária, mas será necessário configurar uma 
nova biblioteca na IDE Arduino, a Esps266Ping.h , que pode ser 
encontrada em https://github.com/dancol90/ESP8266Ping/. Acesse 
esse endereço e faça download da biblioteca toda no formato zip. 
Clique no botão clone or download para ter essa opção. 


Depois de baixar o arquivo zip, abra a IDE Arduino, clique no menu 
Sketch , selecione a opção Incluir Biblioteca € clique na opção 


Adicionar Biblioteca .zip. 


sketch.ino.ino | Arduino 1.8.5 — o x 
Arquivo Editar Sketch Ferramentas Ajuda 
Verificar/Compilar Ctrl+R 
Carregar Ctrl+U 





skatch.ino.in Carregar usando programador Ctrl+Shift+U 
void setup() Exportar Binário compilado Ctri+Alt+S 
ff put yoy 


Mostrar a página do Sketch | Ctrl+K 
} Incluir Biblioteca 3 À 
i Gerenciar Bibliotecas... 


void loop() |. Adicionar Arquivo... 


ff put your main code here, to run repeatedly: Adicionar biblioteca .ZIP 


} Contributed bibliotecas 
Adafruit Circuit Playground 
ArduinoOTA 

Bridge 

DNSServer 

EEPROM 

ESP8266 

ESP8266AVRISP 
ESP8266HTTPClient 
ESP8266HTTPUpdateServer 
ESP8266LLMNR 
ESP8266NetBIOS A 
ESP8266Ping 

ESP8266SSDP A 
ESP8266WebServer 


reamano a rr 





Yv 


ƏPJESP-12 Module), 80 MHz, Flash, 4M (1M SPIFF S), v2 Lower Memory, Disab 





Figura 17.3: Menu Sketch, Incluir Biblioteca e opção Adicionar Biblioteca .zip 


Na janela que abrirá, selecione o arquivo que você acabou de baixar 
e clique no botão abrir. 


Pronto, a biblioteca está inclusa na IDE e pronta para ser usada. 
Vamos ao código-fonte! 


Programação: 


Hinclude <ESP8266Ping.h> 
Hinclude <ESP8266WiFi.h> 


int tentativas = 50; 


char ssid[] = “iPhone de Fernando Bryan"; 


char senha[] = "biycoj7s5s9cs"; 


IPAddress endereco remoto(172, 217, 28, 67); 


void setup() { 
Serial.begin(9600); 
WiFi.begin(ssid, senha); 
Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 
delay(500); 
Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 


Serial.println("Time-out. Verifique as configurações e tente 


novamente."); 
while(true); 


} 


Serial.println("Conectado!"); 
Serial.println(); 
Serial.print("Endereço IP local = "); 
Serial.println(WiFi.localIP()); 


Serial.print("Pingando o IP remoto = "); 


Serial.println(endereco_remoto); 


if(Ping.ping(endereco remoto)) { 
Serial.println("Ssucesso!"3; 
Serial.printin("Tempo de resposta: 
"ms"); 
} else { 
Serial.println("Erro!"); 


+ String(Ping 


.averageTime()) + 


void loop() {} 
O que foi feito: 


A primeira coisa foi colocar a inclusão da biblioteca Esps266Ping.h e 
depois a biblioteca Esps266wiFi.h. 


Na declaração das variáveis, criamos uma variável chamada 
endereco remoto dO tipo IPAddress , OU Seja, ela será capaz de receber 
um endereço IP como conteúdo. O endereço é passado entre 
parênteses na frente da declaração, então temos IPAddress 

endereco remoto(172, 217, 28, 67) para O endereço IP 172.217.28.67 
(Google). 


Caso você queira colocar uma URL em vez do endereço IP, basta 
declarar a variável endereco remoto como ponteiro para char e atribuir o 
endereço, em formato string , para ela. Por exemplo: 


char* endereco remoto = “www.google.com.br”; 


Na função 1oo0p() , usamos o mesmo código para conectar à rede de 
sempre, como nas experiências anteriores. Depois de tudo 
conectado, temos o código novo: 


Serial.print("Pingando o IP remoto = "3; 
Serial.printin(endereco remoto); 


if(Ping.ping(endereco remoto)) { 

Serial.println("Ssucesso!"3; 

Serial.printin("Tempo de resposta: " + String(Ping.averageTime()) + 
"ms"); 
} else { 

Serial.println("Erro!"); 


} 


Com esse trecho, enviamos algumas mensagens ao Monitor Serial 
para conseguir visualizar o que está acontecendo, e usamos a 
estrutura de seleção if(Ping.ping(endereco_remoto)) para verificar se 
houve ou não resposta do equipamento ou servidor remoto. O 


comando Ping.ping(endereco remoto) val “pingar” o endereço remoto e 
retornará true (verdadeiro) caso consiga ou false (falso) caso não 
tenha sucesso. 


Se retornar true , OU Seja, Se O ping foi bem-sucedido, retornarmos 
no Monitor Serial a palavra sucesso . Na sequência, temos o tempo 
médio, em milissegundos, necessário para que a resposta fosse 
enviada e recebida. Quem retorna esse tempo é o comando 
Ping.averageTime() , que, como é do tipo inteiro, precisa ser convertido 
para string com a função String() . 


Resultado esperado: 


Depois de compilado e carregado, abra o Monitor Serial e você terá 
o seguinte resultado caso o endereço possa ser alcançado: 





COM5 — o x 


OSSOS-SSSConectando. ...Conectado! 


Endereço IP local = 172.20.10.5 
Pingando o IP remoto = 172.217.28.67 
Sucesso! 

Tempo de resposta: 97ms 





Auto-rolagem Nenhum final-delinha w | 9600 velocidade ~Țv Deleta a saida 





Figura 17.4: Resultado no Monitor Serial no caso de sucesso 


Caso o endereço não seja alcançável (coloquei um que sei que 
daria erro), o resultado será: 





COoMs - o x 
| Enviar 


Conectando. ...Conectado! 


Endereço IP local = 172.20.10.5 
Pingando o IP remoto = 1.217.28.67 
Erro! 





Auto-rolagem Nenhum final-delinha v (9600 velocidade Ţv Deleta a saida 





Figura 17.5: Resultado no Monitor Serial no caso de insucesso 
Desafio: 


Tente fazer um programa que seja capaz de alternar entre 
endereços remotos para ler uma página Web. Por exemplo, faça 
com que ele “pingue” algum endereço remoto e, caso esse 
endereço esteja disponível, leia uma página; caso contrário, leia 
outra página de outro endereço. 


Com isso, você atribui resiliência ao seu código e, mesmo que o 
servidor remoto entre em manutenção, você terá como ler ou enviar 
dados para outro, sem ter que alterar o código do seu equipamento. 


Na próxima experiência... 


... Você conhecerá como obter a hora atual através da internet 
usando o protocolo NTP, que pode ser muito útil em vários tipos de 
projetos que dependam de verificar a hora para disparar algum 
comportamento, tal qual um alarme. 


Vamos em frente para conferir! 


CAPÍTULO 18 
Experiência nº 14 — Contando tempo com horas 
reais 


Que um dos usos que se pode dar ao NodeMCU é controlar 
máquinas e equipamentos, já sabemos. Podemos fazer isso das 
mais variadas formas, mas um jeito que é essencial é a partir da 
passagem do tempo. 


Ativar, desativar ou realizar qualquer outra tarefa a partir de um 
horário, por exemplo, é útil para diversas soluções que vão desde 
sistemas para irrigação até iluminação. 


O NodeMCU infelizmente não carrega em seu hardware um relógio 
de tempo real, também conhecido como RTC (Real Time Clock). Ou 
usamos um externo, que agrega custo e complexidade extra ao 
projeto, ou podemos solucionar o problema com o protocolo NTP — 
Network Time Protocol ou Protocolo de Horário de Rede. 


O NTP é um protocolo para sincronização de relógios de 
computadores e demais equipamentos, baseado no protocolo UDP 
pela porta 123. A ideia é saber o endereço de um servidor de 
horário NTP e através deste protocolo solicitar a ele a hora atual. 


Como há uma demora entre a solicitação e a resposta, a hora 
recebida do servidor não estará exatamente sincronizada, portanto o 
protocolo inclui um algoritmo para calcular esse atraso, chamado de 
deslocamento (offset). Esse cálculo consiste em saber a diferença 
de horário entre duas requisições de horário ao servidor e, a partir 
da diferença entre elas, ajustar o relógio local com a hora 
adicionada do atraso encontrado. 


Para o NodeMCU há uma biblioteca chamada nrpclient.h que, antes 
de mais nada, deve ser baixada de https://github.com/arduino- 
libraries/NTPClient/ e instalada no seu IDE Arduino, como já fizemos 


anteriormente na Experiência nº 13 - Verificando um endereço 
remoto (ping). 


Com a biblioteca baixada e instalada, vamos em frente para ver tudo 
isso na prática! 


O que é necessário: 

1 x NodeMCU 1 x Cabo USB 
Esquema de montagem: 

Não há montagem necessária. 
Programação: 

tinclude <NTPClient.h> 

tinclude <ESP8266WiFi.h> 

Hinclude <WiFiUdp.h> 

int tentativas = 50; 

char ssid[] = “iPhone de Fernando Bryan"; 


char senha[] = "biycoj7s5s9cs"; 


WiFiUDP ntpUDP; 
NTPClient cliente(ntpUDP); 


void setup()( 
Serial.begin(9600); 
WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 


while(true); 
} 
} 


Serial.println("Conectado!"); 
cliente.begin(); 
cliente.update(); 


} 

void loop() { 
Serial.print("Dia....: "); 
Serial.println(cliente.getDay()); 
Serial.print("Hora...: "); 
Serial.println(cliente.getHours()); 
Serial.print("Minuto.: "); 


Serial.println(cliente.getMinutes()); 
Serial.print("Segundo: "); 
Serial.println(cliente.getSeconds()); 
delay(1000); 
cliente.update(); 

} 


O que foi feito: 


Com o código, depois de importar as novas bibliotecas nTPClient.h , 
COM Hinclude <NTPClient.h>, € WiFiUdp.h, COM Hinclude <WiFiUdp.h>, 
usamos wiFiuDP ntpuDP para criar um objeto chamado ntpupr , que 
será usado para enviar pacotes de requisição NTP ao servidor. Na 
sequência, Usamos NTPClient cliente(ntpuDP) , que cria o objeto 
cliente que usa o objeto ntpup para obter a hora atual. 


Na função setup() realizamos a conexão com a rede sem fio, como 
fizemos em todas as experiências anteriores. Com cliente.begin() 
iniciamos o protocolo NTP e, com cliente.update() , fazemos com 
que uma requisição de atualização seja enviada ao servidor NTP 
pool.ntp.org. Esse endereço é definido diretamente na biblioteca 
NTPClient.h. 


Para a função 1oo0p() temos apenas que obter e mostrar o dia, a 
hora, os minutos e os segundos atuais, usando cliente.getDay() para 


o dia, cliente.getHours() para as horas, cliente.getMinutes() para OS 
minutos e cliente.getseconds() para os segundos. 


Com delay(1000) , fazemos o código pausar por um segundo e 
solicitamos nova atualização da hora com cliente.update() . 


Note que o dia mostrado é o dia da semana e não a data. 
Considerando que cliente.getDay() retorna O para o domingo, você 
pode incluir o seguinte trecho para mostrar o dia da semana por 
extenso: 


switch(cliente.getDay()) { 


case 0: dia = "Domingo"; break; 
case 1: dia = "Segunda"; break; 
case 2: dia = "Terça"; break; 

case 3: dia = "Quarta"; break; 
case 4: dia = "Quinta"; break; 
case 5: dia = "Sexta"; break; 

case 6: dia = "Sabado"; break; 


Resultado esperado: 


Após compilar e carregar o código no NodeMCU, abra o Monitor 
Serial. Depois da conexão estabelecida, você verá o horário sendo 
mostrado “errado”, como na imagem a seguir. Durante um tempo o 
NodeMCU trocará dados com o servidor NTP para calcular o 
deslocamento e sincronizar os horários. 











Enviar 
CONCORDA DA DETIDO RR Conectado! A 
Bana: 4 
Hora. 0 
Minuto 0 
Segundo: 41 
Did....: 4 
Hora. 0 
Minuto 0 
Segundo: 43 
v 
[4] Auto-rolagem Nenhum final-de-linha «>» 9600 velocidade v Deleta a saida 





Figura 18.1: Saída do horário “errado” durante o tempo de sincronização. 


Após alguns segundos você receberá o horário correto. Mas note 
que ele deverá estar pelo menos 3 horas adiantado, por causa do 
fuso horário que não foi informado. Veja a imagem a seguir: 











Enviar 

Segundo: 19 A 
Dia....: 1 
Hora...: 16 
Minuto.: 26 
Segundo: 20 
DES ass 1 
Hora...: 16 
Minuto.: 26 
Segundo: 21 
Dia....: 1 
Hora...: 16 
Minuto.: 26 
Segundo: 22 

v 
Auto-rolagem Nenhum final-delinha w 9600 velocidade ~Ţv Deleta a saida 





Figura 18.2: Horário correto sincronizado, mas sem fuso horário. 


Como não colocamos no código a informação de fuso horário, o 
NTP retornará o horário atual de Greenwich. 


Vamos melhorar o programa para obter a hora atual para o Brasil. 
Além disso, vamos ver como fazer para informar um servidor NTP 
personalizado. 


Programação: 
tinclude <NTPClient.h> 
tinclude <ESP8266WiFi.h> 


Hinclude <WiFiUdp.h> 


int tentativas = 50; 


char ssid[] = “iPhone de Fernando Bryan"; 
char senha[] = "biycoj7s5s9cs"; 
char servidor[] = “a.stl.ntp.br"; 


long fuso = -3 * 60 * 60; 
int tempoAtual, tempoAnterior, contador; 


WiFiUDP ntpUDP; 


NTPClient cliente(ntpUDP,servidor,fuso); 


void setup()( 
Serial.begin(9600); 
WiFi.begin(ssid, senha); 


Serial.print("Conectando..."); 
while (WiFi.status() != WL CONNECTED) 
{ 

delay(500); 


Serial.print("."); 
tentativas--; 
if (tentativas == 0) { 
Serial.printin(); 
Serial.println("Time-out. Verifique as configurações e tente 
novamente."); 
while(true); 
} 
} 
Serial.println("Conectado!"); 
cliente.begin(); 
cliente.update(); 


void loop() { 

tempoAtual = millis(); 

if (tempoAtual - tempoAnterior > 1000) { 
tempoAnterior = tempoAtual; 
contador++; 
Serial.printin("Hora atual: "); 
Serial.println(cliente.getFormattedTime()); 

} 

if (contador >= 86400) { 
cliente.update(); 
contador = ®; 


O que foi feito: 


Nesse novo código, mudamos a declaração do objeto cliente em 
NTPClient cliente(ntpUDP,servidor,fuso) . Além do objeto do protocolo 
NTP, informamos as variáveis servidor € fuso . 


Para termos o endereço do servidor NTP personalizado a.st1.ntp.br, 
declaramos a variável servidor COM char servidor[] = "a.stl.ntp.br". 


Para o fuso horário, declaramos estar a -3 horas de Greenwich com 
long fuso = -3 * 60 * 60 . O fuso tem que ser dessa maneira porque o 
parâmetro esperado está em segundos. 


Na função 1o0p() Usamos um trecho de código diferente: 


tempoAtual = millis(); 

if (tempoAtual - tempoAnterior > 1000) { 
tempoAnterior = tempoAtual; 
contador++; 
Serial.printin("Hora atual: "); 
Serial.println(cliente.getFormattedTime()); 


} 


Em vez de usar a função delay para congelar a execução por um 
segundo, usamos a função millis() , que retorna quantos 
milissegundos se passaram desde o início da execução. Caso esse 
tempo seja maior que 1 segundo, mostramos a hora no Monitor 
Serial. 


Para mostrar a hora no Monitor Serial usamos 
cliente.getFormattedTime() , que já retorna a hora formatada em 
hora:minutos:segundos , Sem a necessidade nos preocuparmos com 
ISSO. 


Já com a segunda parte do novo código: 


if (contador >= 86400) { 
cliente.update(); 
contador = 0; 


} 


Com esse trecho controlamos se já se passaram 24 horas e, em 
caso positivo, realizamos a atualização do horário no servidor NTP. 
Escolhemos fazer isso porque, mesmo que o NodeMCU não tenha 
um relógio interno, ele é suficientemente estável para realizar a 
contagem do tempo sem a necessidade de atualização constante. 
Com isso, economizamos internet. 


Resultado esperado: 


Compilando e carregando você verá no Monitor Serial a hora 
atualizada considerando o fuso horário: 











CoMs - o x 
| Enviar 
Conectando. ...Conectado! A 
Hora atual: 
03:28:37 
Hora atual: 
03:28:38 
Hora atual: 
03:28:39 
Hora atual: 
03:28:40 
yv 
Auto-rolagem Nenhum final-de-linha v 9600 velocidade v Deleta a saida 





Figura 18.3: A hora atualizada já considerando o fuso horário. 


Desafio: 


Que tal construir um alarme despertador? Você pode usar um 
buzzer para emitir algum barulho em determinado horário, mesmo 
que definido diretamente na programação. 


Na próxima experiência... 


... Vamos ver como programar execuções automáticas de trechos de 
código, em vez de tentarmos controlar na função 1o0p() a quantidade 
de vezes ou de tempo que determinado código deve ser executado. 

Aprenderemos como deixar isso acontecer automaticamente. 


Vamos avançar! 


CAPÍTULO 19 
Experiência nº 15 — Execução agendada 


Uma das coisas que já vimos em experiências anteriores é a 
necessidade constante de controlar o tempo de execução de 
trechos dos nossos programas. Seja para controlar algum 
equipamento que esteja ligado ao NodeMCU, seja para que ocorra 
alguma transmissão de dados ou ainda apenas para emitir sinais 
sonoros ou luminosos sobre o funcionamento do que estamos 
criando. 


Uma tática bastante usada e especialmente útil são os avisos 
luminosos sobre o funcionamento do equipamento. Você já deve ter 
reparado que alguns equipamentos possuem um LED que pisca 
pulsando de tempo em tempo para indicar o funcionamento de 
alguma coisa, como detectores de fumaça ou lâmpadas de 
emergência. Pulsar o LED consome menos eletricidade do que 
mantê-lo acesso o tempo todo. 


Para o NodeMCU, mais especificamente, uma boa tática é executar 
tentativas de conexão a uma determinada rede a cada período de 
tempo, caso o equipamento seja móvel, tal qual um coletor de 
dados, por exemplo. A cada tempo, tenta se conectar a uma rede 
para transmitir dados, e quando a conexão é obtida a transmissão 
acontece. 


Note que o tempo exato de execução do código é importante e difícil 
de controlar porque a função delay() bloqueia a execução total do 
programa e isso não é muito desejável em condições reais. Outra 
opção é controlar através da função millis() que, apesar de melhor, 
não nos deixa livres do tempo de execução dos demais trechos do 
programa. 


Vamos fazer um exemplo bem clássico, para ver isso na prática. 
Vamos piscar o LED embutido do NodeMCU a cada segundo, sem 


usar delay() . E vamos aprender quais são seus problemas e qual a 
solução para eles. 


O que é necessário: 
1 x NodeMCU 1 x Cabo USB 
Esquema de montagem: 


Não há montagem necessária. Apenas ligue o NodeMCU ao seu 
computador. 


Programação: 
unsigned long anterior = 0; 


void setup() { 
pinMode(LED BUILTIN, OUTPUT); 


void loop() { 
unsigned long atual = millis(); 


if (atual - anterior >= 1000) { 
anterior = atual; 
digitalwrite(LED BUILTIN, !digitalRead(LED BUILTIN)); 


} 
} 


O que foi feito: 


Declaramos uma variável bastante grande, chamada anterior, e a 
inicializamos com o valor zero, usando unsigned long anterior = 0. 
Essa variável guardará o tempo anterior de execução do programa, 
por isso deve começar com zero. 


Na função setup() apenas ajustamos o pino do LED embutido como 
saída usando pinMode(LED BUILTIN, OUTPUT) . 


Na função 1oop() fazemos tudo funcionar: com unsigned long atual = 
millis() declaramos a variável atual e nela colocamos a quantidade 
de milissegundos durante a qual o programa está sendo executado, 
usando a função millis(), OU seja, por quanto tempo o programa 
está em funcionamento. 


Depois comparamos o tempo inicial (que no início é zero) com o 
tempo decorrido, com if (atual - anterior >= 1080) . Caso esse tempo 
seja maior ou igual a 1000 (lembre-se de que 1000 milissegundos é 
1 segundo), ajustamos para que o tempo anterior seja o atual para 
começarmos a contagem novamente. Isso é feito com anterior = 
atual . Continuando, invertemos o sinal do pino do LED embutido 
com a linha digitalwrite(LED BUILTIN, !digitalRead(LED BUILTIN)). 


A função digitalRead(LED BUILTIN) lê O valor do pino digital do LED 
embutido, que poderá ser HIGH OU Low . O sinal de interrogação 
inverte esse valor, se for HIGH passará para Low e vice-versa. Neste 
momento, entra a função digitalwrite , que aplicará esse valor obtido 
aO LED BUILTIN. 


Resultado esperado: 


Com esse código, o LED embutido do NodeMCU acenderá por um 
segundo. 





Figura 19.1: LED aceso por um segundo. 


E na sequência permanecerá apagado por um segundo, piscando 
continuamente. 





Figura 19.2: LED apagado por um segundo. 


Você pode usar um relógio para comparar se quiser e notará que o 
LED fica aceso e apagado exatamente por um segundo. 


Mas se adicionarmos mais comandos no código, esse tempo 
começa a não ser mais exato, já que o NodeMCU levará um tempo 
para executá-los. Para exagerar nesse tempo vamos usar um delay . 
Vamos alterar nosso programa: 


Programação: 
nsigned long anterior = 0; 
void setup() 1 
pinMode(LED BUILTIN, OUTPUT); 


} 


void loop() { 
unsigned long atual = millis(); 


if (atual - anterior >= 1000) { 


anterior = atual; 
digitalwrite(LED BUILTIN, !digitalRead(LED BUILTIN)); 


} 
delay (2000); 


} 
O que foi feito: 


Adicionamos a função delay(2000) , que gera uma pausa na 
execução do programa por três segundos logo depois do trecho em 
que fazemos o LED acender e apagar. 


Resultado esperado: 


Essa mudança fará com que o LED fique aceso por 3 segundos e o 
mesmo tempo apagado. Isso é causado pela soma de 1 segundo do 
trecho... 


if (atual - anterior >= 1000) { 

anterior = atual; 

digitalwrite(LED BUILTIN, !digitalRead(LED BUILTIN)); 
} 


... adicionado aos dois segundos de delay(2000) . 


A solução para esse problema da demora na execução de 
terminado trecho chave do programa pode ser feita usando-se a 
biblioteca Ticker.h , que nos fornece o objeto Ticker . 


Com esse objeto, é possível programar a execução de determinada 
função através do tempo independentemente da execução normal 
do código. Ou seja, independente do que estiver sendo executado 
naquele instante, se for o momento, ele executará a função 
determinada. 


Vamos ver isso funcionar na prática. 


Programação: 


Hinclude <Ticker.h> 
Ticker agenda; 


void pisca() { 
digitalWrite(LED BUILTIN, !digitalRead(LED BUILTIN)); 
} 


void setup() { 
pinMode(LED_BUILTIN, OUTPUT); 
digitalwrite(LED_BUILTIN, LOW); 
agenda.attach(1, pisca); 


} 


void loop() { 
} 


O que foi feito: 


Importamos a biblioteca Ticker.h com a linha #include <Ticker.h>, 
como já mencionado antes. E ela que vai nos fornecer o objeto 
Ticker para agendamento de execução. 


Criamos um objeto chamado agenda como sendo do tipo Ticker . 
Vamos nos referir à função agendada por meio desse objeto. 


Com o trecho... 


void pisca() { 
digitalwrite(LED_BUILTIN, !digitalRead(LED BUILTIN)); 
} 


... Criamos uma função chamada pisca() , que contém o código para 
inverter o sinal do pino digital do LED embutido, como já fizemos 
antes. Toda vez que chamarmos essa função, caso o LED esteja 
aceso ele apagará, e caso esteja apagado ele acenderá. 


Na função setup() colocamos o pino digital do LED embutido como 
saída, COM pinMode(LED_BUILTIN, OUTPUT) , € fazemos com que ele 
comece apagado, com digitalwrite(LED_BUILTIN, LOW). 


E agora o grande truque: agenda.attach(1, pisca) . Com essa linha, 
adicionamos à agenda a ordem para que a cada 1 segundo seja 
executada a função pisca . O primeiro parâmetro é o tempo de 
agendamento que deve ser informado em segundos, ou seja, por 
exemplo, 1 é um segundo e 0.5 é meio segundo. 


Note que a função 1oop() ficou vazia. 
Resultado esperado: 


Depois de compilar e carregar o código-fonte você deverá ver o LED 
embutido do seu NodeMCU piscar intermitentemente a cada 
segundo. 


Repare que não colocamos nenhum comando na função 1o0p() e O 
que está fazendo com que o código da função pisca() seja 
executado é o agendamento proporcionado pelo objeto Ticker . 


Para deixar mais claro que esse comportamento independe do 
restante do código, vamos mais uma vez lançar mão da função delay 
. Vamos colocar um delay bem exagerado na função 1oop() . 


Programação: 
#include <Ticker.h> 
Ticker agenda; 


void pisca() { 
digitalWrite(LED BUILTIN, !digitalRead(LED BUILTIN)); 
} 


void setup() { 
pinMode(LED_BUILTIN, OUTPUT); 
digitalwrite(LED_BUILTIN, LOW); 
agenda.attach(1, pisca); 


} 


void loop() { 


delay(10000) ; 
} 


O que foi feito: 


Na função 1oop() colocamos um delay(10000) que causa a pausa da 
execução do programa por 10 segundos. 


Resultado esperado: 


Você deve ter continuado a observar o LED embutido do seu 
NodeMCU da mesma forma como antes, mesmo com O delay(10000) 
realizando uma pausa de 10 segundos na execução do programa. 


Eis a prova final de que o objeto Ticker funciona agendando a 
execução da função pisca independente do que mais tiver que ser 
executado. 


Desafio: 


Que tal desenvolver algo como exemplificado na introdução dessa 
experiência? Executar tentativas de conexão a uma determinada 
rede a cada período de tempo - você pode até usar a técnica 
aprendida na Experiência nº 06 para informar diversas redes 
possíveis para conexão. 


E agora? 


Agora é EXPLORAR! Colocar a criatividade para trabalhar, mas 
calma aí, ainda tem mais uma coisa que quero que você saiba antes 
de terminarmos. Avance para descobrir. 


CAPÍTULO 20 
Para encerrar: novas possibilidades 


Se você fizer algumas buscas na internet por "NodeMCU" você 
encontrará que ele foi criado para ser programado com a linguagem 
LUA, mesmo que seja possível fazer isso com a linguagem C do 
Arduino, sendo assim mais fácil para quem já está familiarizado com 
essa plataforma. 


A linguagem de programação LUA foi desenvolvida na PUC-Rio, 
aqui no Brasil, e é usada para diversos fins, desde jogos e robôs a 
aplicações para computadores. 


Por todos esses motivos, os criadores e desenvolvedores do módulo 
NodeMCU incorporaram essa linguagem, sendo que muitos deles 
vêm de fábrica já com o firmware para a linguagem LUA já 
carregado e pronto para ser usado. 


No nosso caso, como já programamos nosso NodeMCU com a IDE 
Arduino, esse firmware acabou-se por ser sobrescrito por nossos 
programas, sendo necessário recarregá-lo ao módulo. Para isso, 
vamos usar o NodeMCU Flasher, que pode ser encontrado em 
https://github.com/nodemcu/nodemcu-flasher/. 


Depois de fazer o download da versão correta para seu computador, 
32 (Win32) ou 64-bits (Win64), execute o arquivo Esp8266Flasher. exe 
que você baixou. 


Na janela que aparecerá, como na imagem a seguir, você terá 
apenas que verificar se a porta serial foi reconhecida corretamente 
e, caso não tenha sido, selecione a porta serial em que seu 
NodeMCU está conectado. 





E NODEMCU FIRMWARE PROGRAMMER 


Operation Config Advanced About Log 


COM Port COMS Flash(F) 


AP MAC Waiting MAC 


STA MAC Waiting MAC 


NODEMCU TEAM 





Figura 20.1: Tela iniciado do NodeMCU Flasher. 


Com a porta serial selecionada corretamente, basta clicar no botão 
Flash . Com isso, O processo de gravação do firmware para a 
linguagem LUA será iniciado e o NodeMCU Flasher mostrará a 
barra de progresso, o endereço MAC para o modo Access Pointe o 
endereço MAC para o modo estação (cliente). 


Ao término da gravação você verá uma indicação verde à esquerda 
inferior da janela do programa e a palavra ready à direita inferior, 
como na imagem a seguir: 





E NODEMCU FIRMWARE PROGRAMMER 


Operation Config Advanced About Log 


COM Port COM5 Flash(F) 


LER o 


NODEMCU TEAM 





Figura 20.2: NodeMCU Flasher com a indicação de término da gravação. 


Feito isso você está pronto para programá-lo em LUA! Resete seu 
NodeMCU e vamos colocar a mão na massa! 


Já existem alguns IDEs para programação LUA no NodeMCU, como 
o ESPlorer, mas como a ideia para terminar este livro é mostrar 
essa possibilidade vamos realizar alguns testes conectando 
diretamente no NodeMCU pela porta serial. 


Para isso, você precisará de algum programa que realize conexões 
terminal via porta serial, como o putty, que utilizaremos para os 
próximos exemplo. Mas se quiser optar por outro, existem, por 
exemplo, o RealTerm e o HyperTerminal. 


Vamos nos conectar ao NodeMCU usando a porta serial que foi 
encontrada na gravação do firmware com velocidade de 9.600 bps 
para o putty, conforme a imagem a seguir: 


Es PuTTY Configuration 


Basic options for your PuTTY session 
Specify the destination you want to connect to 
ET line 


EE 
ORaw O Iene ORlogin (55H (8) Seral 


Load, save or delete a stored session 
Saved Sessions 


Close window on exit 


(O Always ON Œ) Only on clean exit 





Figura 20.3: putty preparado e configurado para conexão com o NodeMCU. 


Ao clicar no botão open (Abrir) a janela do terminal será aberta: 


EP COMS - PuTTY — o x 





Figura 20.4: A janela de terminal do putty, com a conexão estabelecida. 


A partir disso podemos escrever qualquer programa usando LUA, o 
que, caso queira, é a oportunidade de aprender uma nova 
linguagem de programação que vem crescendo no mercado de Tl. 


Vamos tentar o seguinte exemplo: 


gpio.mode(0, OUTPUT); 
gpio.write(0,gpio.HIGH); 
gpio.write(0, gpio.LOW); 


EP COMS - PuTTY — o x 





Figura 20.5: A janela de terminal do putty, com a conexão estabelecida. 


Nesse exemplo usamos o comando gpio.mode(a,ouTPUT); para ajustar 
o pino GPIO 16 como saída, assim como fazemos pinMode(o,OUTPUT); 
quando programamos usando a linguagem C para Arduino. 


Com gpio.write(o, gpio.HIGH); Colocamos o pino GPIO 16 em modo 
HIGH, de forma similar ao que fazemos usando a linguagem C para 
Arduino com digitawrite(o,HIGH); . Aqui muda também a forma de 
referência à constante HIGH, sendo que na linguagem LUA ela está 
na classe gpio . A mesma lógica é aplicada para a linha 
gpio.write(O,gpio.LOW); . 


Apenas é preciso relembrar a relação dos pinos GPIOs com seus 
índices: 


Índice GPIO 
(0) GPIO 16 


Índice GPIO 
1 GPIO 5 
GPIO 4 
GPIO 0 
GPIO 2 
GPIO 14 
GPIO 12 
GPIO 13 
GPIO 15 
GPIO 3 
GPIO 1 
GPIO 9 
12 GPIO 10 


o Oo N O Oo A OO N 


— | me 
+ O 


Aprender programação para NodeMCU a partir de conhecimentos 
prévios de Arduino deixa tudo mais simples e fácil, além do apoio 
que pode ser obtido na documentação que é mantida em 
http://nodemcu.readthedocs.io/. 


Como você deve ter percebido, o NodeMCU tem todas as 
facilidades do Arduino, incluindo a opção de uma linguagem de 
programação alternativa e a capacidade de conexão com redes WiFi 
nativamente - e todas as possibilidades que isso traz consigo. 


Agora, para terminarmos você só precisa liberar sua criatividade, 
desafiar-se e criar máquinas e equipamentos inovadores para 
mudar o mundo. 


Força! 


